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About This Manual 


This manual describes the Professional Programming Environment 
(PPE), a software development tool available under the CONTROL DATA® 
Network Operating System/Virtual Environment (NOS/VE) executing on a 
cDC® CYBER 180 computer. 


While using PPE, the user can execute several other NOS/VE 
development tools, including the Full-Screen Editor (FSE), the 
Source Code Utility (SCU), the Full-Screen Debug utility, and the 
object library generator. These tools are fully described in other 
manuals listed in appendix B; the means of accessing these tools 
within a PPE session is described in this manual. 


Audience 


This manual is written for use by all PPE users. The primary user 
is expected to be a programmer working as part of a multi-person 
programming project that is developing a product for use under the 
NOS/VE operating system. The product under development must be 
written in one of the languages supported by PPE. PPE supports the 
NOS/VE CYBIL, COBOL, FORTRAN Version 1, and FORTRAN Version 2 
compilers. 


You will find PPE easiest to use if you are familiar with the 
Full-Screen Editor (FSE), the Full-Screen Debug interface, the 
Source Code Utility (SCU), and the Programming Environment. 
However, the object-oriented user interface and context—sensitive 
online help make PPE easy to learn even if you have little NOS/VE 
experience. 


Organization 


This manual is organized into four chapters. The first two chapters 
introduce you to PPE concepts and help you complete your first PPE 
session. The third chapter gives step-by-step procedures for 
performing the primary PPE operations. The fourth chapter provides 
two quick-reference listings, the first for PPE screens and the 
second for PPE commands. 


Appendixes provide a glossary, a list of related manuals, the ASCII 
character set table, a description of the PPE catalog structure, a 
summary of the PPE function key labels, and suggestions for using 
PPE to create and maintain software. 


Revision B About This Manual 5 


About This Manual 


Conventions 


blue 


UPPERCASE 


lowercase 
Initial 
Caps 
numbers 
Quick 


Reference 
format 


Within examples of interactive sessions, user input is 
shown in blue print. System output is shown in black 
print. 


In PPE command syntax, uppercase indicates a statement 
keyword or character that must be written as shown. 
For purposes of examples, however, lowercase is used. 


In PPE command syntax, lowercase indicates a name, 
number, symbol, or entity that you must supply. 


All screen names are initial capped. 


All numbers are assumed to be base 10 unless otherwise 
noted. 


The PPE commands and screens are described in Quick 
Reference format. The purpose, format, and special 
remarks of each command or function are described. 
Also, in most cases, an example is demonstrated. 


Submitting Comments 


The last page of this manual is a comment sheet. 


Please tell us 


about any errors you find in this manual and any problems you have 


using it. 


If the comment sheet in this manual has been used, please send your 
comments to us at this address: 


Control Data Corporation 
Technology and Publications Division 


P.O. 


6 Professional Programming Environment 


Box 3492 
Sunnyvale, California 


94088-3492 


Revision B 


About This Manual 


Please include the following information with your comments: 


The manual title and publication number (PPE Usage, 60486613) 
and the revision letter from the page footer. 


Your system’s PSR level (if you know it). 


Your name, your company’s name and address, your work phone 
number, and whether you want a reply. 


Also, if you have access. to SOLVER, the CDC online facility for 
reporting problems, you can use it to submit comments about this 
manual. When it prompts you for a product identifier for your 
report, please specify SW8. 


In Case of Trouble 


Control Data”s CYBER Software Support maintains a hotline to assist 

you if you have trouble using our products. If you need help beyond 
that provided in the documentation or find that the product does not 
perform as described, call us at one of the following numbers and a 

support analyst will work with you. 


From the USA and Canada: (800) 345-9903 
From other countries: (612) 851-4131 


The preceding numbers are for help on product usage. Address 
questions about the physical packaging and/or distribution of 
printed manuals to Literature and Distribution Services at the 
following address: 


Control Data Corporation 

Literature and Distribution Services 
308 North Dale Street 

St. Paul, Minnesota 55103 


or you can call (612) 292-2101. If you are a Control Data employee, 
call (612) 292-2100. 
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Introduction 1 


The Professional Programming Environment (PPE) is a software 
development tool available under the NOS/VE operating system 
executing on a CYBER 180 computer. 


PPE uses a full-screen, object-oriented interface. The user can 
select objects on the screen by positioning the cursor on the 
object. Actions are selected by pressing function keys or by 


entering SCL commands on the home line of the screen. (Full-screen 
terminal definition is described in chapter 2.) 


PPE Capabilities 


This section lists the primary PPE capabilities. The concepts 
underlying these capabilities are described later in this chapter. 


As a programming environment, PPE integrates the programming tasks, 
including: 


e Editing source text. 

@ Compiling source text. 
e Debugging source text. 
@ Executing object code. 


In addition, PPE can coordinate the activities of a multi-person 
programming project. To do so, it provides these capabilities: 


e Full-screen interface to Source Code Utility (SCU) deck and 
modification creation. 


e Extraction and transmittal of SCU decks and modifications within 
a source library hierarchy. It enforces interlocks to ensure 
that only one copy of a deck can be changed. 


© Expansion and compilation of the product source, including 
copying decks from higher levels of the hierarchy when a deck is 
not present at the lowest level. 

e Tracing of compilation errors to the decks containing the source. 

e Maintenance of an object library at each level of the 


hierarchy. Each object library contains the compiled code for 
the source decks at that level. 
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PPE Limitations 


e Partial builds of the product, expanding and compiling only 
those source decks that have changed. 


e Execution of the product version at the current level of the 
hierarchy, using object modules at higher levels as needed. 


PPE Limitations 


PPE use has the following limitations: 


e All code for the product being developed must be written in one 
language. 


e The programming languages supported are NOS/VE FORTRAN Version 1 
and NOS/VE COBOL. 


e PPE does not support SCU features or groups, nor does it provide 
a method of changing modification or deck header information. 
To assign features and decks to groups (or change other header 
information), you can enter SCU subcommands on the home line or 
use SCU directly. For more information, see the NOS/VE Source 
Code Management Usage manual. 


e PPE does not provide a method of using SCU selection criteria 
files. 


Background Concepts 


This section discusses concepts that you should understand before 
using PPE. Read this section if you are not already familiar with 
these topics: 


e NOS/VE Source Code Utility (SCU) 
© PPE catalog hierarchy 


e Build process 


NOS/VE Source Code Utility (SCU) 


The Source Code Utility (SCU) is the NOS/VE utility PPE uses to 
maintain source text on source libraries. PPE provides a 
full-screen interface for creating and selecting decks and 
modifications. For more information, see the NOS/VE Source Code 
Management manual. 


The following paragraphs give a brief description of SCU decks and 
modifications. 
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SCU Decks 


SCU manipulates source text as units called decks. Each SCU source 
library contains a collection of decks. Each deck contains a 
sequence of source lines. A deck can be referenced by name. Source 
text is edited one deck at a time. 


To compile selected decks, PPE calls SCU to produce the input file 
for the build processor (the compiler). SCU expands the selected 
decks. The expansion process includes processing any SCU directives 
embedded in the deck and then writing the deck text to a file for 
compilation. 


Two SCU directives frequently embedded in decks are the copy 
directives, *COPY and *COPYC. When a copy directive is processed, 
the text from the deck named on the directive is copied into the 
deck text at the point where the copy directive is embedded. The 
*COPY directive copies unconditionally; the *COPYC directive copies 
only if the deck has not been copied into the deck before. 


Each deck has an expand attribute. If the attribute is set to TRUE, 
the deck can be selected for expansion; if the attribute is set to 
FALSE, the deck can be expanded only when it is copied into another 
deck. 


& SCU Modifications 


SCU maintains a history of changes made to the source text in a 
source library. It does so by assigning each change to the 
modification in effect when the change is made. This includes line 
additions, replacements, and deletions. 


PPE Catalog Hierarchy 


To help coordinate multi-person programming projects, PPE supports 
an environment which maintains several versions of the product. 
Each version contains product code at a certain state of 
development, such as untested, unit-tested, and system-tested. 
These product versions form a hierarchy; code progresses up the 
hierarchy as it passes stages of evaluation. 


System-Tested 
Code 
Unit-Tested 
Code 
Untested 
Code 
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Background Concepts 


PPE implements this hierarchy of levels as a hierarchy of NOS/VE 
file catalogs. Each catalog contains all files applicable to its 
product version, including a source library, an object library, and 
various listing and data files. (The files are listed in appendix 
D.) 


When a person joins a project that uses PPE, he links his PPE 


catalog to the PPE catalog hierarchy of the project. In this way 
his catalog becomes a catalog at the lowest level of the project 


hierarchy. 
System-Tested 
Code 
Unit-Tested 
Code 


Martha’s 
Untested 
Code 


Fred’s 
Untested 
Code 


George’s 
Untested 
Code 


Extracting Decks 


PPE users can create new decks in their PPE source libraries or 
extract existing decks from higher levels of the hierarchy. PPE 
extracts a deck by these steps: 


1. It searches for the deck, starting at the next higher level and 
going up the hierarchy until it finds the deck. 


2. It then makes a copy of the deck and adds it to the source 
library at the lowest level of the hierarchy. It does not 
extract the deck to any intermediate levels of the hierarchy. 


An interlock is set on the deck when it is extracted. This prevents 
other users from extracting the deck until after it has been 
transmitted. When an interlock is set, the user’s identification 
and the date and time of the interlock are stored in two deck header 
Fields: the sub interlock field in the higher-level source library 
copy and the original interlock field in the lower-level source 
library copy. = 
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The following illustration shows the interlocks before and after 


Fred extracts deck A: 


Before Fred Extracts Deck A 


System-Tested Code 


Deck A 
Original Interlock: 
Sub Interlock: 


After Fred Extracts Deck A 


System—-Tested Code 


Deck A 
Original Interlock: 
Sub Interlock: Fred 


Unit-Tested Code Unit-Tested Code 


Fred”~s Untested Code Fred~s Untested Code 


Deck A: 
Original Interlock: Fred 
Sub Interlock: 


Transmitting Decks 


To transmit a deck means to move the deck from the lowest level 
where it currently resides to the next higher level. You can only 
transmit decks from the your level of the environment catalog 
hierarchy to the source library at the next higher level. 


When PPE transmits a deck, it copies the deck from the lowest level 
and combines the copy with the source library at the next higher 
level. If a copy of the deck already exists at the higher level, it 
is replaced by the lowest-level copy if deck interlocks match. If 
the deck at the next level does not have a matching interlock value, 
the transmit fails. After a successful transmittal, the deck is 
deleted from the lowest-level source library. 


When a transmitted deck has the same name as a deck already existing 
in the higher-level source library, it must be a copy of the deck 
extracted from the higher-level source library. The deck interlock 
is enforced; this means that the original interlock value in the 
lower-level deck must match the sub interlock value in the 
higher-level deck; otherwise, the lower-level deck copy is not 
allowed to replace the higher-level copy and the transmittal fails. 
If the interlock values match, the transmittal succeeds; the 
interlock is cleared and the lower-level deck copy is deleted. 
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Background Concepts 


The following illustrates transmitting decks. When Fred finishes 
his changes to deck A, he transmits it to the Unit-Tested level: 


Before Fred Transmits Deck A 


System-Tested Code 


Deck A 
Original Interlock: 
Sub Interlock: Fred 


Unit-Tested Code 


Fred”s Untested Code 


Deck A: 
Original Interlock: Fred 
Sub Interlock: 


The diagram above shows the PPE hierarchy as you would see it if you 


After Fred Transmits Deck A 


System-Tested Code 


Deck A 
Original Interlock: 
Sub_Interlock: Fred 


Unit-Tested Code 


Deck A: 
Original Interlock: Fred 
Sub Interlock: 


Fred”s Untested Code 


executed PPE for the catalog containing Fred”s Untested Code. The 


view has three levels with Fred”s Untested Code at the bottom. 
hierarchy view presented by PPE always has the catalog for which PPE 


is executed as the bottom level of the hierarchy. 


If you executed PPE specifying the catalog containing the 
Unit-Tested Code from the diagram above, you would see only two 
hierarchy levels: the System-Tested Code and the Unit-Tested Code 
levels. PPE provides no information about hierarchy levels below 


the level for which it is executed. 
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Background Concepts 


If you executed PPE for the Unit-Tested Code level, the hierarchy 


would appear as shown below. 


To transmit deck A from the Unit-Tested Code level to the 
System-Tested Code level, you must execute PPE from the Unit-Tested 


Code level. 


You can only transmit a deck from your level, and it 


can only be transmitted to the next higher level. 


Before You Transmit Deck A 


System-Tested Code 


Deck A 
Original Interlock: 
Sub Interlock: Fred 


Unit-Tested Code 


Deck A: 
Original Interlock: Fred 
Sub Interlock: 


After You Transmit Deck A 


System—-Tested Code 


Deck A 
Original Interlock: 
Sub Interlock: 


Unit-Tested Code 


Because 


The transmittal checks that the interlock fields match. 
they do, the transmittal takes place; the Unit-Tested Deck A copy 
replaces the System-Tested Deck A copy, the Deck A interlock is 
cleared, and the Deck A copy is deleted from the Unit-Tested Code 
level. 


Build Process 


The build process transforms source code into executable object 
code. The build process has two steps: source text expansion and 
compilation. These steps are described in this section. 


At completion of the build process, you are shown a build report. 
If the build failed, the report describes the errors. If the build 
succeeded, the report lists the output files available for 
examination. 


Although you can initiate the PPE build process by pressing a single 
function key, you can, before doing so, provide additional input for 
each step of the process. The following paragraphs describe the 
build steps in more detail and discuss the additional input you can 
provide. 
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Source Text Expansion 


SCU expands the source text in the decks to produce the input file 
for the build processor. 


As described earlier under SCU Decks, part of the expansion process 
involves copying other decks into the decks being expanded. SCU 
searches for each deck to be copied in the following locations in 
the order shown: 


1. In the PPE source library at the current level. 
2. In the PPE source library at each higher level upwards. 


3. In the source libraries listed in the alternate base library 
list in the order the library files are listed. 


A single alternate base library list is used for all builds at a 
level. You can change the contents of the list at any time. 


Compilation 


The second step in the build process is the processing of the 
expanded text by the build processor. Currently, this is always 
compilation by a compiler. The compiler generates an object module 
for each compilation unit. The object modules are stored in the 
object library for the current PPE level. 


You can select the parameter values used by the build processor. 

PPE maintains a library of parameter lists. For example, FORTRAN 
parameter lists are available for high and low optimization and 
debug mode. You can select the parameter list used and, if desired, 
change parameter values. 


For more information about compiler parameter values, you can use 
the HELP command to take you to the parameter discussion in the 
compiler online manual. 


Product Execution 


After the product has been successfully built, it is available for 
execution testing. You execute the product by pressing the function 
key or entering the command RUN. (Or, you can tailor PPE so it 
automatically executes the product at the end of each successful 
build.) 


PPE allows you to specify the parameter list passed to the product 
when it is executed. If the product requires access to one or more 
attached data files, you can attach those files by entering the SCL 
command ATTACH FILE on the home line. 
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You can designate one of two purposes for a run: normal or 
interactive debug. An interactive debug run executes the product 
under control of the Full-Screen Debug utility. 


Execution begins at the default starting procedure (the last 
transfer symbol loaded) unless you specify another starting 
procedure, 


You can also specify the program library list and command list 
entries. The command list entries are command libraries to be added 
to the command list. The command list determines the SCL commands 
available during the PPE session. The program library list is a 
list of additional object libraries from which object modules can be 
loaded as needed. Modules are loaded to satisfy external 
references. To find a module containing an entry point that matches 
an external reference, the loader searches the following locations 
in the order presented: 


1. In the PPE object library at the current level. 


2. In the PPE object library at each higher level upwards in the 
hierarchy. 


3. In the object libraries specified in the program library list on 
the Library Lists screen. The libraries are searched in the 


order listed. 


4. In the object libraries listed in the job library list. The 
libraries are searched in the order listed. 


The program loading process is described in more detail in the SCL 
Object Code Management manual. 
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Getting Started 2 


This chapter describes how you can begin to use PPE. To do so, you 
must: 


1. Define your terminal as a full-screen terminal. 


2. Enter the SCL command to start PPE. 
3. On initial entry to PPE, set up your own PPE level. 


These topics are described in detail in the following sections. 


Defining Your Terminal 


Because PPE uses a full-screen interface, it can only be used from 
an interactive terminal that has full-screen capabilities and is 
defined for full-screen use. 


If you have used a full-screen application from your terminal (such 
as editing in screen mode using the NOS/VE Full-Screen Editor), your 
terminal is a full-screen terminal and you can prepare your terminal 


for PPE the same way you prepare it for other screen mode 
applications. 


However, if you have not used a screen mode application from your 
terminal before, you need to learn how to define your terminal as a 
full-screen terminal. You may be able to find out from someone else 
at your site. If not, continue reading. The following paragraphs 
list the characteristics of a full-screen terminal and describe how 
you define your terminal as a full-screen terminal. 


Full-Screen Terminal Characteristics 


A terminal can be defined as a full-screen terminal if it has the 
following minimum characteristics: 


e Uses asynchronous communications. 


e Has keys that move the cursor on the screen and transmit 
characters indicating that the cursor has moved. 


e Supports direct cursor addressing. 


6 Provides a clear-screen operation. 


Revision B Getting Started 2-1 


Defining Your Terminal 


The following terminal characteristics are also desirable: 
e Provides a clear-to-end-of-line function. 


@e Has up to 32 definable function keys, each of which transmits a 
unique, identifying character sequence. Preferably, the 
sequence should end with the carriage-return character. 


@e Allows host definition of tab stops. 


e Supports protected screen fields and tabbing between unprotected 
fields. The tab key must transmit a character sequence to the 
host indicating that the key was pressed. 


@e Has graphic characters for drawing lines. 


Full-Screen Terminal Definition 


A terminal is defined as a full-screen terminal when you provide 
NOS/VE with a full-screen terminal definition to use during the 
interactive session. You do this by specifying a TERMINAL MODEL 
parameter value on the SCL command CHANGE TERMINAL . ATTRIBUTE. You 
can put the CHANGE TERMINAL ATTRIBUTE command in your prolog file 
(SUSER. PROLOG) so it is executed each time you log in to NOS/VE. 


The TERMINAL MODEL parameter value selects a predefined description 
of your terminal. Your site probably has a set of terminal 
definitions available on file $SYSTEM.TDU.TERMINAL DEFINITIONS. To 
see the definitions available at your site, enter the following SCL 
command: 


display object library Ssystem.tdu.terminal definitions 


The command lists the names of the terminal definition modules. By 
convention, the names begin with the prefix CSM$ followed by the 
TERMINAL MODEL value. For example, one of the modules may be a 
terminal definition for the Zenith 229 terminal named CSM$Z29. To 
use the CSM$Z29 module, you enter the following command: 


change terminal attribute terminal model=z29 


Many terminals provide a VT100 (or ANSI X3.64) mode. If your 
terminal does, you may not find its name in the list of terminal 
models supported, but using VT100 should work. If you cannot find a 
compiled terminal definition available at your site that is 
effective for your full-screen terminal, you or someone at your site 
must create a new terminal definition. The process of creating a 


new terminal definition is described in the Terminal Definition for 
NOS/VE manual. 
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Using Function Keys 


One of the important features of the full-screen interface is the 
use of function keys. However, the actual function keys available 
to you depend on the terminal you use. 


You may need to consult the manual for your terminal or the person 
who wrote the terminal definition to find the function keys on your 
keyboard. For some terminals, function keys are entered by a 
combination of keys entered at the same time or in sequence. For 
example, on the Z29 terminal, unshifted function keys are the top 
row of keys on the keyboard and shifted function keys are the SHIFT 
key and a numeric pad key entered at the same time. After entering 
a Z29 function key, you must press the RETURN key. 


As listed under Full-Screen Terminal Characteristics, function keys 
are not required to use PPE. When the terminal definition does not 
define function keys, all PPE actions must be specified by commands 
entered on the home line. 


In many cases, a terminal has some function keys, but not a full set 
of 32. In such cases, some PPE functions are available via function 
key, while others must be entered by commands on the home line. 

The function keys defined by the terminal definition are displayed 
at the bottom of the screen. 


Function keys can be entered shifted or unshifted. On the display 
at the bottom of a PPE screen, the top label is for the shifted key 
and the bottom label is for the unshifted key. 


The function key label is always valid as the corresponding home 
line command, unless the label is changed by the user. Thus, when 
a description refers to a function key label, the referenced 
function can be performed by pressing the function key, entering the 
command on the home line of the screen, or by entering the function 
key label on the home line of the screen. 


User Breaks in a Full-Screen Application 


A user break alows you to interrupt an interactive program. To 
activate user break 1 and user break 2 in a full-screen application 
such as PPE, you must enter one or two commands before entering the 
application. 


User_break_1 (also known as pause break) and user_break 2 (also 
known as terminate break) are interactive conditions caused when the 
user enters a certain key sequence. A terminate break condition 
terminates the currently executing command. 
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A pause break condition discards typed-ahead input and suspends the 
executing command. While the command is suspended, you can interact 
with the system to get information such as the job”s status, consult 
online manuals, and so forth. To resume the suspended command, 
enter RESUME COMMAND; to terminate the suspended command, enter 
TERMINATE COMMAND. 


CDCNET Commands 


If the communications network you are using is CDCNET, you must 
enter two commands. The first command defines the attention 
character value; the second command defines the attention character 
as the terminate break key and the terminal”s break key as the 
pause break key. The following example assumes that the network 
control character is the default (%) and the attention character is 
to be defined as CTRL-T (ASCII DC4, character code 20): 


Achange terminal attribute attention_character=20 
*change connection_attribute attention character action=1 .. 
break character _action=2 
or abbreviated, 
#chata ac=20 
Achaca aca=l1 bka=2 
NAM/CCP Command 
If the communications network you are using is NAM/CCP, you enter 
only one command. The command changes the attention character to a 
non-null value. For example: 
change terminal attribute attention_character=$char(20) 


or abbreviated, 


chata ac=$char(20) 
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Starting PPE 


After preparing your terminal for full-screen use, you can start PPE 
by entering the SCL command ENTER PPE, defined as follows: 


& Format: ENTER _ PPE or ENTP 
ENVIRONMENT CATALOG=catalog path 
STATUS=status_ variable 


Parameters: ENVIRONMENT CATALOG or EC 
Path to the subcatalog for which PPE is 
executed. It becomes the lowest level of the 
your PPE hierarchy in the session. 


PPE creates the subcatalog if it does not exist. 
If the subcatalog belongs to another user, the 
owner must grant you the following catalog permit: 


Access Modes=(all, cycle, control) 
Application_Information="I11° 


If you omit ENVIRONMENT CATALOG, the default 
subcatalog used is $USER.PROFESSIONAL ENVIRONMENT. 


STATUS 
Optional status variable in which the command 
@ returns its completion status. 
Examples: The following command starts a PPE session in which 


the PPE level used is the default subcatalog, the 
user”s SUSER.PROFESSIONAL ENVIRONMENT subcatalog. 


entp 


The following command begins a PPE session using the 
subcatalog named SUSER.XYZ.PPE WORK: 


entp ec=$user.xyz.ppe_work 
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Entering PPE for the First Time 


The first screen you see each time you enter PPE is the PPE Banner 
screen. The Banner screen appears similar to the following display: 


Professional Programming Environment (PPE) 


Level 87300 


Version 1.1 


COPYRIGHT CONTROL DATA 1987 


Press Next to proceed with the PPE session. 
Press Help to learn about the PPE. 
Press Quit (STOP) to exit the PPE. 


The Banner screen prompts you to make one of three choices: 


NOTE 


Commands cannot be entered on the home line of the Banner screen. 
Only commands executable by function keys are available. 


1. Press Next to proceed with the PPE session. 


This choice displays the Environment Description screen allowing 
you to begin use of PPE. To select this choice, press the 


carriage-return key. (The carriage-return key transmits the 
carriage-return character; on various terminals, it is labeled 


RETURN, NEXT, CR, or a similar label.) @ 
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NOTE 


When you select the first choice (Use Next to proceed with the 
PPE session), PPE creates the PPE catalog structure in the 
catalog specified on the ENTER PPE command if the catalog has 
not been used as a PPE catalog before. The existing files and 
catalogs in the specified subcatalog are not affected. For more 
information on the PPE catalog structure, see appendix D. 


Press Help to learn about the PPE. 


If you select this choice, you are shown the online manual 
introduction to PPE. To get help, press the Help key. 
Depending on your terminal definition, this could be the key 
labeled HELP on your terminal or a function key labeled Help at 
the bottom of the Banner screen. 


Press Quit (STOP) to exit the PPE. 


This choice ends the PPE session without creating the PPE 
subcatalog. To leave PPE, press the Stop or Quit key. 
Depending on your terminal definition, this could be the key 
labeled STOP on your terminal or a function key labeled Quit at 
the bottom of the Banner screen. 


The Banner screen is always the first screen displayed when you 
enter PPE. However, the screen displayed when you proceed can 
differ. The screen displayed when you press the carriage-return key 
is the last screen displayed during your previous PPE session. This 
allows you to continue your work where you left your previous 


session. 
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Environment Description Screen 


During your initial PPE session, the PPE screen you see after 
pressing the carriage-return key from the Banner screen is the 
Environment Description screen. At first, the Environment 
Description screen appears similar to the following (the function 
key labels at the bottom of your screen may differ): 


ENVIRONMENT DESCRIPTION 


SCU objects: DECKS MODIFICATIONS 


Hierarchy level name: WORKING 


This level is Linked to environment catalog: 


Build processors: FORTRAN 


Hierarchy Level names 


PLists Stack Banner 
Ft |ChaDCs |F2 |SCUObj | F3| Tailor] F4i Import |F5 jBProcsiF6] Quit JF7/LLists| F8)EdiPL 


You can begin by naming your PPE level. The name can be any 
descriptive sequence of 1 through 31 characters that follows NOS/VE 
naming rules. To name your level, type the level name after 


Hierarchy level name: 


You can type over any existing level name to to change your level 
name. However, be sure to strike over all characters of the old 
name. If the new name does not replace all characters of the old 
name, erase the remaining characters of the old name with blanks. 


Press the carriage-return key and your new name appears in the 
Hierarchy level names list at the bottom of the screen. 
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Linking to a Hierarchy 


The Environment Description screen defines how your PPE level 
relates to other PPE levels in a hierarchy. Initially, your level 
is not linked to any hierarchy. You are not required to link to a 

@ hierarchy. However, if you intend to extract decks from and 
transmit decks to higher levels of a hierarchy, you must link your 
level to the hierarchy. 


To link your PPE level to a hierarchy, specify the level to which 

your level is to be linked. Specify the hierarchy level by its 

catalog path. Type the catalog path on the line below the heading: 
This level is linked to environment catalog: 

Press the carriage-return key and the level names in the hierarchy 

will appear in the Hierarchy level names list. Your level name will 

be at the bottom of the list. 

For example, to name an environment catalog level 

FREDS UNTESTED CODE, type the following level name in the Hierarchy 

level name: field: 


freds untested code 


The Environment Description screen then appears similar to the 


€ following: 


ENVIRONMENT DESCRIPTION 


SCU objects: DECKS MODIFICATIONS 


Hierarchy Level name: FREDS UNTESTED CODE 


This level is Linked to environment catalog: 


Build processor: FORTRAN 


Hierarchy Level names 


© Banner Tailor | BProcs iLLists 
-. FIPLLists|]F2 [SCUObj {FSi Import |F4iChaDdc | F5 F6} Quit [F7IEdiPL j|F8 Stack 
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The environment catalog level is named FREDS UNTESTED CODE. The 
level name is added to the Hierarchy level names list. Since 

FREDS UNTESTED CODE is not linked to any other catalogs, it belongs 
to no environment catalog hierarchy and no other level names are 
listed in the Hierarchy level names list. 


You can work on code using an environment catalog not connected to a 
hierarchy, but you cannot extract from or transmit to other PPE 
catalogs. To do so, your environment catalog must be linked to 
another environment catalog. 


A typical environment catalog hierarchy might consist of an 
integration level, a project level, and an analyst level. An 
integration level and project level hierarchy might appear similar 
to the following: 


Integration 
Level SYSTEM 
TESTED | 
CODE — 
Project 
Level UNIT @ 
TESTED 


CODE | 
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If you want to link your level to another environment catalog, you 
must specify the file path of the catalog on the This level is 
linked to: field of your Environment Description screen. For 
example, to link the environment catalog level FREDS UNTESTED CODE 
to the UNIT TESTED CODE environment catalog level, specify the file 

@& path of the UNIT | TESTED ) CODE environment catalog. After you specify 
the path, the Environment Description screen appears similar to the 
following: 


ENVIRONMENT DESCRIPTION 


SCU objects: DECKS MODIFICATIONS 


Hierarchy level name: FREDS UNTESTED CODE 


This level is Linked to environment catalog: 


:SYSTEM_NAME.USER NAME.UNIT TESTED.CODE 


Build processor: FORTRAN 


Hierarchy level names 
SYSTEM TESTED CODE 
UNIT_ _TESTED CODE 


Banner Tailor BProcs LLists 
FIILLists] F2 |SCUObj | F3 F4iChadc 1 FS F6 F7IEdiPL IF8 
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The Hierarchy level names list contains the level names in Fred’s 
environment catalog hierarchy. FREDS UNTESTED CODE is the bottom 
level of the hierarchy. If you could see the hierarchy, it would 
appear similar to the following: 


integration 
Level SYSTEM 
TESTED _ 
CODE | 
Project 
Level UNIT 
TESTED | 
CODE | 
Analyst 
Level FREDS 


UNTESTED 


CODE | @ 


Fred can now transmit decks to and extract decks from the 
environment catalogs in the environment catalog hierarchy. 
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Build Processor 


Notice the Build processor: field on the Environment Description 
screen. This field specifies the processor used for all builds at 
your level of the hierarchy. Initially, the Build processor: field 
is set to FORTRAN, indicating that the NOS/VE FORTRAN Version 1 
compiler is the build processor used. 


You can change the value in the Build processor: field by typing 
over the existing value. The specified build processor is used for 
all subsequent builds and so it must be an appropriate processor for 
the source code at your level. For example, it would not be 
appropriate to specify COBOL as the build processor when the source 
code to be compiled is FORTRAN source code. 


Display Build Processors 

To see a list of all build processors currently supported by PPE, 
request the DISPLAY BUILD PROCESSORS function by either of the 
following: 

e Press the function key labeled BProcs, or 

e Move the cursor to the home line, type the command 


DISPLAY BUILD PROCESSORS (or DISBP or BPROCS), and press the 
carriage-return key. 
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The Build Processors screen appears similar to the following display: 


BUILD PROCESSORS 


Processor 


COBOL 
C 


| Banner Tailor PLists 
FIJLLists|F2{EdiDT | F3 F4|ChaBP | F5 F6 F7{EdiPl | F&I] Stack 


The build processor in use is highlighted on the Build Processors 
screen. To change the build processor, do one of the following: 


e Position the cursor on the build processor name and then press 
the function key labeled ChaBP, or 


e Position the cursor on the build processor name, press the HOME 
key, type the command CHANGE BUILD PROCESSOR (or CHABP), and 
press the carriage-return key, or 


e Move the cursor to the home line, type the command 
CHANGE BUILD PROCESSOR (or CHABP) followed by the build 
processor name, and press the carriage-return key. 


The other functions available from the Build Processors screen are 
described in the screen description in chapter 4. To return to the 
Environment Description screen, either: 
e Press the BACK function key, or 
@ Move the cursor to the home line, type the command 

BACK TO PREVIOUS CONTEXT (or BACTPC or BACK), and press the 


carriage-return key, or 


e Use the Screen Stack screen. 
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Tailor Options Screen 


During your first PPE session, you might also look at the Tailor 
Options screen. It provides a number of options for tailoring your 
PPE level. 


To display the Tailor Options screen, do either of the following: 
e Press the function key labeled Tailor, or 
e Move the cursor to the home line, type the command 


DISPLAY TAILOR OPTIONS (or DISTO or TAILOR), and press the 
carriage-return key. 


The Tailor Options Screen appears similar to the following: 


TAILOR OPTIONS 


USEROO7 


Author: 


Interlock value: USEROO7 


Build defaults: 
Build processor: FORTRAN 


Run automatically after build: — YES X_NO 


Run defaults: 
Starting procedure: 
Purpose: X NORMAL __INTERACTIVE DEBUG 


Delete Protection: 


X_ON __OFF 


Editing defaults: 
User prolog: 
PPE editor key assignments: BEFORE USER X_AFTER USER — NONE 


Banner BProcs PLists 
FI{LLists | F2 F3 F4 FS F6] Quit [F7/EdiPL /[F8/Stack 


Initially, the values in the Author: and Interlock value: fields 
are the same; both are the NOS/VE user name of the job containing 
the PPE session. The Author: value on the Tailor Options screen is 
the default value PPE enters in the Author deck header field of 
created decks. The Interlock value: is the value PPE enters in the 
interlock fields when a deck is extracted. 


If you like, you can change the Author and/or Interlock values to a 
value more descriptive, such as your name. To do so, type over the 
existing values and then press the carriage-return key. 
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The Build defaults are values used as defaults when the product is 
built. The Build processor value on the Tailor Options screen is 
the same as it is on the Environment Description screen. As 
described for the Environment Description screeen, you can change 
the Build processor value by typing over it and pressing the 
carriage-return key. Be sure to overstrike and blank out all 
characters of the old value, because any characters of the old value 
that remain on the screen become part of the new value. The value 
must be a keyword specifying one of the build processors supported 
by PPE. 


The default value for the Run automatically after build field is NO, 
meaning that the product is not executed at the end of a successful 
build. If you like, you can change the value to YES, causing the 
product to execute after every successful build. To change the 
value, type a non-blank character in the field next to YES and press 
the carriage-return key. 


The Run defaults are default values used when the product is 
executed. When the Starting procedure field is blank, execution 
begins at the last transfer symbol loaded, usually the main 
program. If you like, you can change the value to the name of a 
specific entry point where execution is to begin. To do so, type 
the name in the Starting procedure field and press the 
carriage-return key. (For a more detailed description of starting 
procedures, see the NOS/VE Object Code Management Usage manual). 


The Purpose field sets the default run purpose for each execution of 
the product. Two run purposes are available: 


e Normal execution (NORMAL) 


e Execute under control of the Debug utility (INTERACTIVE DEBUG) 


To change the default run purpose, type a non-blank character in the 
field you select and press the carriage-return key. 


The Delete protection default allows you to enable or disable delete 


protection. Delete protection warns you when objects are about to 
be physically deleted. Options are: 


ON PPE issues a warning before physically deleting an object. 
You can then veto or confirm the deletion of the object. 


This is the default selected by PPE. 


OFF PPE physically deletes objects without allowing you to veto 
the action. 


To select either option, type a non-blank character in the field to 
the left of the option. 
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When you use a DELETE command (for example, DELETE DECK), the 
deleted object is logically deleted. This means that the name of 
the object is removed from the screen, but the object is still 
physically resident in PPE. Logically deleted objects can be 
recovered with the UNDO LAST DELETE command. 


A logically deleted object becomes physically deleted if: 


® Delete protection is ON and you confirm the deletion. The 
Delete protection warning is displayed when you attempt to leave 
the current screen, execute a command on the home line, or 
execute a command that might reference a logically deleted 
object. 


@ You exit PPE. When you exit PPE, all logically deleted objects 
become physically deleted. The delete protection warning is not 
displayed even if you selected Delete protection from the Tailor 
Options screen. 


e Delete protection is OFF and you leave the current screen, 
execute a command on the home line, or execute a command that 
might reference a logically deleted object. No deletion warning 
is displayed and you cannot veto the deletion. 


A physically deleted object cannot be recovered by invoking the 
UNDO _LAST DELETE command. PPE can physically delete only objects 
that are logically deleted. 


The Editing defaults: fields enable you to specify an editor prolog 
to be used when executing the PPE editor. The editing defaults let 
you define editor function keys using a combination of your function 
key definitions and PPE commands or using your function key 
definitions only. Therefore, when entering the PPE editor, you can 
use the PPE supplied editor prolog, an editor prolog of your choice, 
or a combination of both to define the editor function keys. 


If you want to define the PPE editor function keys using your editor 
prolog, enter the file path of your editor prolog in the User 
prolog: field. For example, to use C721 EDITOR PROLOG to define 
PPE editor function keys, type the following file path in the User 
prolog: field: 


Suser.C721 editor prolog 
If you do not specify an editor prolog in this field, PPE uses the 
editor prolog, SCU_EDITOR PROLOG, to define the editor function 


keys. If the file, SCU EDITOR PROLOG, does not exist, PPE defines 
the editor function keys using the standard function key definitions. 
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The PPE editor key assignments: fields allow you to specify whether 
you want PPE editor key assignments made before or after your editor 
function key assignments are made, or whether you do not want any 
PPE editor key assignments made. The choices are: 


BEFORE USER Causes PPE to assign PPE commands to the editor 
function keys before executing your editor 
prolog. First PPE assigns PPE commands to the 
editor function keys, then the editor prolog 
assigns commands to the editor function keys. 


AFTER USER Causes PPE to assign PPE commands to the editor 
function keys after executing your editor 
prolog. First the editor prolog assigns commands 
to the the function keys, then PPE assigns PPE 
commands the keys. 


NONE Causes PPE to not assign any PPE commands to the 
editor function keys. 


When you choose BEFORE USER or AFTER USER, both PPE defined and user 
defined function keys are specified for the PPE editor. Any 
function key defined by both your user prolog and by PPE commands 
assumes the definition assigned to the key last. Therefore, to use 
your editor prolog with the PPE editor prolog to maximum effect, do 


the following: @ 


e Determine which function keys are assigned PPE commands. 


e Define your editor prolog only for function keys not assigned a 
PPE command. 


e Specify the file path of your editor prolog on the User prolog: 
field (the editor prolog can be any file containing EDIT FILE 
function key definitions). 


e Choose BEFORE USER or AFTER USER on the PPE editor key 
assignments: field. 


From the Tailor Options screen, you may also want to go to the 
Library Lists, Parameter List, and Parameter List Library screens. 
To go to these screens, you can use the function keys labeled 
LLists, EdiPL, and PLists or the commands DISPLAY LIBRARY LISTS, 
EDIT PARAMETER LIST, and DISPLAY PARAMETER LIST LIBRARY. These 
screens are described in chapter 4. 
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Leaving PPE 


You can end your PPE session at any time. When you exit PPE from 
any screen other than the Deck Creation or Modification Creation 
screens, all of the files created and options selected are saved for 
your next PPE session. If you exit PPE from the Deck Creation or 
Modification Creation screens, any new information entered on the 
screen is lost. 


To leave PPE, do one of the following: 
e Press the STOP key if your terminal has one, or 
@ Press the function key labeled Quit, or 


e Move the cursor to the home line, type the command QUIT SAVE (or 
QUIT or QUIS or QUI), and press the carriage-return key. 


The next time you enter PPE, the first screen you are shown after 
the Banner screen is the last screen at which you performed an 
action in the previous session unless you exited from the Screen 
Stack screen. 


File Cycle Management Within the Environment Catalog 


When you exit PPE, a new high cycle of the source library within 

© your environment catalog is created. The low cycles allow you to 
recover from catastrophic events. However, you can easily use up a 
large amount of file space. To avoid using excess file space, you 
should frequently delete the low cycles of your source library. You 
can use EDIT CATALOG from the home line of your environment catalog 
to do this. | 


The next chapter is an extended example of the primary PPE 
functions. The chapter following it is a reference chapter that 
describes all PPE screens and commands in detail. 
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This chapter contains procedures for performing the primary PPE 
operations. These include: 


Moving from screen to screen 
Importing a source library 
Creating a modification 
Creating a deck 
Extracting a deck 
Editing a deck 
Building the product 
Correcting errors 
Transmitting code 
This chapter does not describe all PPE commands or all PPE screens. 


The next chapter contains comprehensive descriptions of all PPE 
commands and screens. 


See Appendix G, Usage Hints, for suggestions about using PPE with 
exiting SCU libraries and on new projects. Appendix G also shows 
you how to customize the PPE function key assignments. 


NOTE 


Changes made to the source library are not available to other tasks 
or PPE sessions at lower levels in the hierarchy until you exit the 
PPE session in which the changes occurred, or until the changed 
decks are transmitted to the next higher level in the hierarchy. 


Moving from Screen to Screen 


Moving from screen to screen within PPE does not actually accomplish 
any work, but it is an operation that is required for doing work. 
You can go to a screen by entering the specific command to display 
that screen or you can use the Screen Stack. (To find out which 
command displays a specific screen, look up the screen”s description 
in this manual.) 
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AS you move down the PPE screen hierarchy, each screen you display, 
except the Banner screen and the Screen Stack screen, is put on the 
stack. Each time you move back up the hierarchy, the current 
screen is removed from the stack. You can use the Screen Stack to 
go directly to a screen if the screen is currently on the stack. 


Thus, the PPE screens can appear on the stack only in hierarchical 
order. The hierarchy of PPE screens is as follows: 


1. Environment Description 
2. Deck List or Modification List 


3. Build Errors, Build Files, Run Files, or the Deck Creation or 
Modification Creation screen from Deck List or Modification 
List, respectively. 


The diagram below shows the PPE screen hierarchy. The screens not 
connected to any other screens can be reached from many screens. 
See the PPE Screens section of chapter 4 to determine which screen 
transitions are possible. 


ENVIRONMENT 

DESCRIPTION 
DECK MODIFICATION 
LIST LIST 


BUILD DECK MODIFICATION 
ERRORS CREATION CREATION 
BUILD RUN 
FILES FILES 
TAILOR BANNER SCREEN BUILD 
OPTIONS STACK PROCESSORS 


PARAMETER 
LIST LIBRARY 
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You can retrace your path down the PPE screen hierarchy by using 
BACK TO PREVIOUS CONTEXT repeatedly. To do so, do either of the 
following: 


® Press the BACK function key, or 


Move the cursor to the home line, type BACK TO PREVIOUS CONTEXT 
(or, BACTPC or BACK) and press the carriage-return key. 


You can jump directly to a screen in the stack using the Screen 
Stack screen. To go to the Screen Stack screen, press the function 
key labeled STACK or move the cursor to the home line, type the 
command DISPLAY SCREEN STACK (or DISSS or STACK), and press the 
carriage-return key. The Screen Stack screen then appears, similar 
to the following: 


SCREEN STACK 


ENVIRONMENT DESCRIPTION 
DECK LIST 
DECK CREATION 


To go to a screen on the stack: 


1. Position the cursor on the screen name (such as ENVIRONMENT 
DESCRIPTION). 


_ 2. Press the function key labeled BacTC. 


PPE removes all entries below the selected screen from the stack 
and then displays the requested screen. 
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To create a modification: 


1. Go to the Modification List screen. 


screen is on the screen stack, you can return there by using the 
Screen Stack screen or by using BACK one or more times. 


If the Modification List 


you must go to the Environment Description screen or the Deck 


List screen and perform one of the 


@ Position the cursor on the SCU 
press the function key labeled 


e Position the cursor on the SCU 
press the carriage-return key, 


following: 


object MODIFICATIONS and 
SCUObj, or 


object MODIFICATIONS and 
or 


@ Move the cursor to the home line, type 
DISPLAY SCU_OBJECT LIST MODIFICATION (or DISSOL M or SCUOBJ 
M), and press the carriage-return key. 


The Modification List screen appears, similar to the following: 


MODIFICATION LIST 


SCU objects: DECKS MODIFICATIONS 


Modification 0 thru O of O 


Current mod: Display ceiling: FRED 


Nearest residence 


UnMark Tailor BFiles BProcs Delete Locate Lower EndMrk 
F1j/Create | F2|SCUObj] F3|RFiles|F4|ChaCM |F5] Undo |F6] Quit |F7|Raise |F8{ Mark 
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2. Go to the Modification Creation screen. To do so, do either of 
the following: 


8 Press the function key labeled Create, or 


@ e Move the cursor to the home line, type CREATE MODIFICATION 
(or CREM or CREATE), and press the carriage-return key. 


The Modification Creation screen appears, similar to the 
following: 


MODIFICATION CREATION 


Name: 


Author: Fred Johnson 


Descriptions: 


Banner 
Fil Create | Fe F3 F4 F5 F6] Quit [F7 F8|Stack 


3. Enter the information defining the modification. 


Type the modification name (1 through 9 characters) in the Name 
field. 


By default, the Author field contains the Author value from the 
Tailor Options screen. To change it, type over its current 
value. 


The modification description is optional. [It usually describes 
} the purpose of the modification. To enter it, type the 


information on the lines following the label: 


Description: 


Revision A PPE Operations 3-7 


Creating a Modification 


4. 


Cancel or create the modification. 


Canceling the modification discards the information entered on 
the Modification Creation screen and returns you to the previous 
screen displayed. 


To cancel a modification: 
@ Press the function key labeled Back, or 


@ Move the cursor to the home line, type 
BACK TO PREVIOUS CONTEXT (or BACTPC or BACK) and press the 
carriage-return key. 


Creating the modification causes PPE to give the information on 
the Modification Creation screen to SCU which, in turn, creates 
the modification in the source library. PPE then returns you to 
the Modification List screen. 


If a modification with the same name already exists at any level 
in the PPE hierarchy, PPE does not create the the modification. 
Instead, it displays an explanatory message and leaves you at 
the Modification Creation screen. You can then change the 
modification name and request creation again or, you can leave 
the screen. 


To create a modification: 
e Press the function key labeled Create, or 


@ Move the cursor to the home line, type CREATE MODIFICATION 
(or CREM or CREATE) and press the carriage-return key. 


Creating a Deck 


As described in chapter 1, an SCU deck contains a sequence of source 
lines. Often, the source text in a deck is for a compilation unit, 
such as a FORTRAN or COBOL subprogram. PPE provides a full-screen 
interface for deck creation. 


AaR 
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Creating a Deck 


To create a deck: 


1. Go to the Deck List screen. If the Deck List screen is on the 
Screen stack, you can return there by using the Screen Stack 
screen or pressing BACK one or more times. If not, you must go 
® to the Environment Description screen or the Modification List 
screen and perform one of the following: 


@ Position the cursor on the SCU object DECKS and press the 
function key labeled SCUObj, or 


@ Position the cursor on the SCU object DECKS and press the 
carriage-return key, or 


@ Move the cursor to the home line, type 
DISPLAY SCU_OBJECT LIST DECK (or DISSOL D or SCUOBJ D), and 
press the carriage-return key. 


The Deck List screen appears, similar to the following: 


DECK LIST Deck O thru O of O 


SCU objects: DECKS MODIFICATIONS 


Current mod: MY_MOD Display ceiling: FRED 


Nearest residence 


UnMark Build BFiles Tras Delete Locate Lower EndMrk 
F1jiCreate |F2|BuiD F3IRFilesiF4] ExtS [FS] Undo |F6] Quit |[F7{Raise {F8] Mark 
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2. Go to the Deck Creation screen by doing any one of following: 
® Press the function key labeled Create, or 


@ Move the cursor to the home line, type CREATE DECK (or CRED 
or CREATE), and press the carriage-return key. 


The Deck Creation screen appears, similar to the following: 


DECK CREATION 


Creation modification: MY_MOD 
Name: 


Author: Fred Johnson 


Deck is expandable: X TRUE FALSE 


Initial source: 
X_NONE — DECK TEMPLATE 


File: 


Attributes: — CONTAINS DECK DIRECTIVES — HAS MULTIPLE PARTITIONS 


Description 


Banner 
F1iCreate|F2 F3 F4 FS F6] Quit |F7 F8 


3. Enter the deck header information. 


Type the deck name (1 through 31 characters) in the Name field. 


The default author is the Author value from the Tailor Options 
Screen. To change the author value, type over the value in the 


Author field. 


The creation modification is the modification to which the 
original set of lines in the deck are assigned. It is the 
current modification as shown Deck List screen. To change the 
modification value, type over the value in the Creation 
Modification field. If the modification does not exist at any 


level of the environment catalog hierarchy, PPE asks whether you 


want the modification created with SCU default values. 
Otherwise, if the modification does not exist at the lowest 
level of the hierarchy, PPE issues a message and returns the 
modification field to its previous state. 
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If you let PPE create the modification with SCU defaults, the 
author parameter of the modification is not set. Only values 
provided by the SCU are used to create the modification; 
information on the Deck Creation screen is not used. 


The expand attribute determines whether the deck can be expanded 
directly or whether it must be copied by another deck. The 
default expand attribute is TRUE. To change the value, type a 
non-blank character by the FALSE field following the label: 


Deck is expandable: 


The Initial source: information describes the text stored in 

the deck when it is created. By default, no text is stored in 
the deck. You can specify that the initial source is the deck 
template or the text in a file. 


The procedure for editing the deck template is described later 
under Editing the Deck Template. 


If the initial text is in a separate file, type the file path in 
the File field. When the initial text is in a file, you can 
also specify one or both of the attributes CONTAINS DECK 
DIRECTIVES and HAS MULTIPLE PARTITIONS. 


When you select the attribute CONTAINS DECK DIRECTIVES, SCU 
processes any *DECK directives embedded in the source text. 

Each *DECK directive marks the beginning of the text for another 
deck. The *DECK directive specifies the name of the deck. All 
other deck header information is identical for all decks created 
from the file. 


When you select the attribute HAS MULTIPLE PARTITIONS, SCU 
continues copying text from the file even when it encounters 
end-of—partition delimiters. It converts each end-of-partition 
delimiter to a *WEOP embedded directive, which is converted back 
to an end-of-partition delimiter when the deck is expanded. 


The final field on the screen is the deck description. A 
description is optional. It usually describes the content of 
the deck. 


Cancel or create the new deck. 


Canceling the deck discards the information entered on the Deck 
Creation screen and returns you to the previous screen displayed. 


To cancel a deck: 
e Press the function key labeled Back, or 
® Move the cursor to the home line, type 


BACK TO PREVIOUS CONTEXT (or BACTPC or BACK) and press the 
carriage-return key. 
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Creating the deck causes PPE to give the information on the Deck 
Creation screen to SCU which, in turn, creates the deck (or 
decks) in the source library. PPE then returns you to the 
previous screen displayed. 


To create a deck, do either of the following: © 
® Press the function key labeled Create, or 


@ Move the cursor to the home line, type CREATE DECK (or CRED 
or CREATE), and press the carriage-return key. 


If a deck with the same name already exists at any level in the 
environment catalog hierarchy, PPE does not create the deck. 
Instead, it displays an explanatory message and leaves you at 
the Deck Creation screen. You can then change the deck name and 
create the deck, or you can leave the screen. 


NOTE 


PPE does not check to ensure that a deck is unique in the 
environment catalog hierarchy if you specify a file as the 
initial source of the deck and the file contains deck directives. 


Editing the Deck Template © 


Each build processor (compiler) has a PPE deck template associated 
with it. The deck template is a generic framework for decks written 
in the compiler language; the template can be copied to a deck being 
created. You can edit the deck template to fit your requirements. 
To edit the deck template, perform these steps: 


1. Go to the Build Processors screen by doing either of the 
following: 


e Press the function key labeled BProcs, or, 


@ Move the cursor to the home line, type 
DISPLAY BUILD PROCESSORS (or DISBP or BPROCS), and press the 
carriage-return key. 
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2. Do either of the following: 


e Position the cursor on the build processor whose template 
you want to see and press the function key labeled EdiDT, or 


e Move the cursor to the home line, type EDIT DECK TEMPLATE 
(or EDIDT) and the name of the build processor, and press 
the carriage-return key. 


The deck template is displayed for editing in a Full-Screen 
Editor session. The commands available are described under 
Editing a Deck. 


Extracting a Deck 


The third method of getting decks into your PPE source catalog 
(besides importing source libraries and creating decks) is 
extracting decks from higher levels in the PPE hierarchy. You 
extract a deck when you need to make changes to source code that 
already exists in a higher level. 


As described in chapter 1, extracting a deck makes a copy of the 
deck and adds it to your PPE source library. It sets an interlock 
on the deck so nobody else can extract the deck until after you 
transmit it. 


To extract a deck: 


1. Go to the Deck List screen. If the Deck List screen is on the 
Screen stack, you can return there by using BACK one or more 
times or by using the Screen Stack screen. If not, you must go 
to the Environment Description screen or the Modification List 
screen and perform one of the following: 


® Position the cursor on the SCU object DECKS and press the 
function key labeled SCUObj, or 


e Position the cursor on the SCU object DECKS and press the 
carriage-return key, or 


e Move the cursor to the home line, type 


DISPLAY SCU_ OBJECT LIST DECK (or DISSOL D or SCUOBJ D), and 
press the carriage-return key. 
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2. Raise the display ceiling until the deck (or decks) to be 
extracted is in the list on the screen. (The procedure for 
raising the display ceiling is described later under Raising the 
Display Ceiling.) 


Often, higher levels have long deck lists, causing the deck list 
to be longer than can be displayed on a single screen. 
Therefore, you may need to move forward and backward through the 
list to find the decks to be extracted. (The procedures for 
repositioning a list are described later under Repositioning a 
List.) 


3. Mark the deck (or decks) to be extracted. (The procedures for 
marking objects in a list are described later under Marking 
Objects in a List.) 


If no decks are marked, the deck under the cursor is extracted. 


4. To extract the deck (or decks), either: 
e Press the function key labeled ExtS, or 


@ Move the cursor to the home line, type EXTRACT SOURCE (or 
EXTS) and press the carriage-return key. 


PPE extracts as many of the marked decks as it can. If it cannot 
extract one or more of the decks, PPE displays an informative 
message listing the decks that were not extracted. A deck cannot be 
extracted if it is already interlocked or if it exists at your level 
of the hierarchy. (It may be interlocked because you have already 
extracted it. You can see that this is so if the level listed in 
the Nearest residence column beside the deck name is the name of 
your PPE level.) 


Raising the Display Ceiling 

On many screens, you can raise the display ceiling. The display 
ceiling is the highest level in the hierarchy whose contents are 
included in the list on the screen. Raising the display ceiling 
adds the contents of higher levels to the list. 

To raise the ceiling one level, either: 


e Press the function key labeled Raise, or 


@ Move the cursor to the home line, type RAISE DISPLAY CEILING (or 
RAIDC or RAISE), and press the carriage-return key. 
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To raise the ceiling more than one level, type the number of levels 
after the RAISE DISPLAY CEILING command. To raise the ceiling to 
the top of the hierarchy, type TOP after the RAISE DISPLAY CEILING 
command. 

The level name of the display ceiling appears in the Display Ceiling 
field. 

Repositioning a List 

Many PPE screens display lists of objects. The lists are often too 
long to fit on the screen. The list header indicates how many 
entries are in the list and which entries are currently displayed. 
You can reposition a list display to find the objects you require; a 


list can be repositioned as follows: 


@ Forward or backward one page. (A page is the number of entries 
that can fit on the screen.) 


e Forward or backward so that the object under the cursor is 
positioned at the top or bottom of the page, respectively. 


@ Forward to the end of the list or backward to the beginning of 
the list. 


The following paragraphs describe how you perform these 
repositioning operations. 


To move a list one page forward: 

@ Press the function key labeled Fwd, or 

@ Move the cursor to the home line, type PAGE FORWARD (or PAGF or 
FWD), and press the carriage-return key. 

To move a list one page backward: 

6 Press the function key labeled Bkw, or 

@ Move the cursor to the home line, type PAGE BACKWARD (or PAGB or 


BKW), and press the carriage-return key. 


To move a list so the object under the cursor is at the top of the 
page: 


e Press the function key labeled Up, or 


@ Move the cursor to the home line, type MOVE TO TOP (or MOVTT or 
UP), and press the carriage~return key. 
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To move a list so the object under the cursor is at the bottom of 

the page: 

@ Press the function key labeled Down, or 

@ Move the cursor to the home line, type MOVE TO BOTTOM (or MOVTB 
or DOWN), and press the carriage-return key. 

To display the beginning of a list and move the cursor to the first 

object: 

e Press the function key labeled First, or 

@ Move the cursor to the home line, type MOVE TO FIRST (or MOVIF 
or FIRST), and press the carriage-return key. 

To display the end of a list and move the cursor to the last object: 

@ Press the function key labeled Last, or 


@ Move the cursor to the home line, type MOVE TO LAST (or MOVTL or 
LAST), and press the carriage-return key. 


Marking Objects in a List 

Many PPE screens display lists from which one or more objects can be 
selected. Multiple objects are selected by marking them in the 
list. PPE highlights the marked objects (assuming the terminal 
definition provides a highlighting capability). 


To mark one object: 


1. Position the cursor on the object to be marked in the list. 


2. Either: 
@ Press the function key labeled Mark, or 
e Put the cursor on the object, then move the cursor to the 


home line, type BEGIN MARK (or BEGM or MARK), and press the 
carriage~return key. 
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To mark a range of objects in the list: 


1. Mark the first object in the range using the procedure for 
marking one object. 


2. Mark the last object in the range by first positioning the 
cursor on the last object and then either: 


e Press the function key labeled EndMrk, or 


e Move the cursor to the home line, type END MARK (or ENDM or 
ENDMRK), and press the carriage-return key. 


You can mark more than one individual object or object range in the 
list. 


If necessary, you can remove marks previously set. 


To remove all marks, move the cursor to the home line, type 
REMOVE MARK ALL (or REMM A), and press the carriage-return key. 


To remove only one mark or range of marks: 


e Position the cursor on the mark before pressing the UnMark 
function key, or 


@ Move the cursor to the home line, type REMOVE MARK RANGE (or 
REMM R) or REMOVE MARK INDIVIDUAL (or REMM 1), and press the 
carriage~-return key. 


Editing a Deck 


The actual work of changing source code is accomplished by editing 
decks. When you request deck editing, PPE puts you into a 
full-screen editing session with the text of the deck to be edited 
displayed. 


You can edit a deck from the Deck List screen or the Deck Creation 
screen. The changes made during the editing operation are assigned 
to the modification in the Current Modification field of the Deck 
List screen or the Creation Modification field of the Deck Creation 
screen. Check that the correct modification is specified before 
doing the edit operation. 
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To edit a deck being created: 


1. 


Go to the Deck Creation screen and enter the deck information 
(as described under Deck Creation). 

Request editing: 

@ Press the function key labeled Edit, or 


@ Move the cursor to the home line, type EDIT DECK (or EDID or 
EDIT), and press the carriage-return key. 


To edit an existing deck: 


1. 


Go to the Deck List screen. If the Deck List screen is on the 
screen stack, you can return there by using BACK one or more 
times. If not, you must go to the Environment Description 
screen or the Modification List screen and perform one of the 
following: 


@ Position the cursor on the SCU object DECKS and press the 
function key labeled SCUObj, or 


@ Position the cursor on the SCU object DECKS and press the 
carriage~return key, or 


@® Move the cursor to the home line, type 
DISPLAY_SCU_OBJECT_LIST DECK (or DISSOL D or SCUOBJ D), and 
press the carriage-return key. 


Position the cursor on the deck to be edited. 


When you request editing of a deck at a higher level in the 
hierarchy, PPE also extracts the deck. To display higher 
levels, raise the display ceiling as described under Raising the 
Display Ceiling. Paging forward and backward through a deck 
list is described under Repositioning a List. 


3-18 Professional Programming Environment Revision A 


Editing a Deck 


3. Request editing: 
@ Press the function key labeled Edit, or 


& Move the cursor to the home line, type EDIT DECK (or EDID or 
EDIT), and press the carriage-return key. 


PPE starts a full-screen editing session to edit the text in the 
deck. To leave the editor and return to PPE with your changes 
saved, do one of the following: 

® Press the STOP key or, 


@ Press the function key labeled Quit or, 


@ Move the cursor to the home line, type QUIT, and press the 
carriage-return key. 


All standard full-screen editor commands are available in an 
editing session under PPE. (The editor commands are described 
in the Full-Screen Editor for NOS/VE manual.) PPE also provides 
some specialized capabilities including: 

@ Topic lookup in the compiler online manual and, 


® Source text formatting. 


@ These additional Full-Screen Editor capabilities are described next. 


Online Manual Lookup 


If, while editing, you need to see the online manual information 
about a keyword in your source text, do the following: 


1. Position the cursor on the keyword. 


2. Request lookup, by either of the following: 
e Press the function key Labeled LookUp, or 


@ Move the cursor to the home line, type LOOKUP_KEYWORD (or 
LOOK or LOOKUP), and press the carriage-returm key. 
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LOOKUP KEYWORD passes the keyword as a topic string to the EXPLAIN 
utility which searches for the topic in the index of the compiler 
online manual. If the topic is in the index, the corresponding 
screen of the online manual is displayed. You can read the topic 
and search the manual for other information as desired. (For more 
information on reading an online manual, press the HELP key while 
inside the manual.) 


To return to PPE from the online manual, press the QUIT key. 


Formatting Source Text 


When you edit your source, you can use the PPE provided command 
FORMAT SOURCE TEXT to format the source text. 


FORMAT SOURCE TEXT looks for a command with a name of the form 
FORMAT - processor name SOURCE where processor name is the name of the 
processor for the source program or deck being edited (for example, 
FORMAT COBOL SOURCE). If FORMAT SOURCE TEXT finds a command with a 
name of this - forn, it executes the command. Two parameters are 
passed to the command: the name of the source file to be formatted, 
and the name of the file to contain the formatted source. 


If a command of the form FORMAT processor name SOURCE is not found 
and PPE provides a source code formatter for the processor, then the 
PPE provided formatter is used to format the source code. 

Currently, PPE only provides a source code formatter for FORTRAN 
Version l. 


If a command of the form FORMAT processor name SOURCE is not found 
and PPE does not provide a source code formatter for the processor, 
PPE issues a message informing you that a formatter does not exist 
for the processor. 


PPE provides a formatter for FORTRAN Version 1 source code. The 
formatter standardizes the appearance of your source code, including 
indenting block structures and positioning labels. However, the 
source text must already be in the correct zones (labels in columns 
1 through 5, statements beginning in column 7). 


To format the source text of the deck being edited, do either of the 
following: 


e Press the function key labeled Format, or 


e Move the cursor to the home line, type FORMAT SOURCE TEXT 
(FORST), and press the carriage-return key. 
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Building the Product 


As described in chapter 1, to build the product means to expand the 
text source decks and compile the expanded text. The build process 
produces an updated object library containing the executable code 
for the product. 


PPE provides two types of build operations: one to build changed 
decks, and the other to build selected decks. 


Building Selected Decks 
To build selected expandable decks: 


1. Go to the Deck List screen. If the Deck List screen is on the 
Screen stack, you can return there by using the Screen Stack 
screen or pressing BACK one or more times. If not, you must go 
to the Environment Description screen or the Modification List 
screen and perform one of the following: 


@ Position the cursor on the SCU object DECKS and press the 
function key labeled SCUObj, or 


@ Position the cursor on the SCU object DECKS and press the 
carriage-return key, or 


@ Move the cursor to the home line, type 


DISPLAY SCU_OBJECT LIST DECK (or DISSOL D or SCUOBJ D), and 
press the carriage-return key. 
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The Deck List screen appears, similar to the following: 


DECK LIST Deck O thru O of O 


SCU objects: DECKS MODIFICATIONS 


Current mod: MY_MOD Display ceiling: FRED 


Nearest residence 


UnMark Build BFiles Tras Delete Locate Lower EndMrk 
FliCreate [F2iBuiDd FSIRFiles{[F4] ExtS [FS] Undo [FS] Quit [F7>Raise [F8] Mark 


2. Select the decks by marking individual decks or ranges of decks 
as described under Marking Objects in a List. If no decks are 
marked, only the deck under the cursor is selected. 


3. Request the build by doing either of the following: 
@ Press the function key labeled BuiD, or 


@ Move the cursor to the home line, type BUILD DECKS (or 
BUID), and press the carriage-return key. 


The resulting object modules are combined with the existing object 
library at this level of the hierarchy. Existing modules with the 
Same name are replaced and new modules are added to the hierarchy. 


A deck can be expanded only if its expand attribute is YES (as 
specified when the deck was created). If non-expandable decks are 
selected for the build, PPE ignores the non~-expandable selections 
unless all decks selected are non-expandable. In that case, it 
issues an informative message because no build is performed. 
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A failed build is one in which the compiler detects one or more 
errors. If the build fails, PPE executes a DISPLAY BUILD ERRORS 
command, which displays the Build Errors screen. Otherwise, if the 
build succeeds, PPE displays the Run Files screen. Also, if the 
build succeeds and the Run Automatically option is selected on the 
Tailor Options screen, the product is executed after the build. 


Building Changed Decks 


The build process for building changed decks is the same as 
described previously for building selected decks. The only 
differences are that no deck selection is performed and only changed 
decks are built. 


PPE considers a deck to be changed if it or any deck it references 
resides at the lowest level of your environment catalog hierarchy 
and has changed since the last build. A deck is considered changed 
if it has been explicitly selected on an EDIT DECK command from the 
Deck List screen. A deck edited by using SELECT DECK or EDIT DECK 
while editing another deck or while outside the PPE is not detected 
as having been changed by PPE. 


To build all changed expandable decks, do either of the following: 


@ Press the function key labeled Build, or 


@ Move the cursor to the home line, type BUILD CHANGED DECKS (or 
BUICD or BUILD), and press the carriage-return key. 


Correcting Errors 


If a build detects one or more compilation errors, PPE displays the 
Build Errors screen at termination of the build operation. You can 
also display the Build Errors screen by using the 

DISPLAY BUILD ERRORS command. 
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To go to the Build Errors screen, perform these steps: 


1. Go to the Deck List screen. If the Deck List screen is on the 
screen stack, you can return there by using BACK one or more 


times. If not, you must go to the Environment Description 
screen or the Modification List screen and perform one of the 
following: 


@ Position the cursor on the SCU object DECKS and press the 
function key labeled SCUObj, or 


@ Position the cursor on the SCU object DECKS and press the 
carriage-return key, or 


@ Move the cursor to the home line, type 
DISPLAY _SCU_ OBJECT LIST DECK (or DISSOL D or SCUOBJ D), and 
press the carriage—return key. 


2. Request the Build Errors screen, by doing either of the 
following: 


@ Press the function key labeled Errors, or 


@ Move the cursor to the home line, type DISPLAY BUILD ERRORS 
(or DISBE or ERRORS), and press the carriage-return key. 


The Build Errors screen appears similar to the following: © 


BUILD ERRORS Deck 1 thru 3 of 3 
Detected on 06/23/86 at 14:41 
Current modification: MY MOD 


Deck Error count 


ADD_FORM 
DISPLAY_FORTRAN_PARMS 


PETSFORM DISPLAY TASK_SET 


UnMark Tailor BProcs PLists EndMrk 
FIILLists|F2|Stack {F3iBanner{F4] ExtS {F5 F6} Quit [F7/EdiPL | F8! Mark 
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The Build Errors screen shows the following information: 
e The time and date of the build. 


e The name of the modification to which any editing changes are 
assigned. 


e A list of the decks in which compilation errors were detected 
and the number of errors in each deck. 


To correct the errors in a deck, you must edit the deck text. To 
edit a deck, perform the following steps: 


1. Position the cursor on the deck to be edited. 
2. Request editing by doing either of the following: 
e Press the function key labeled Edit, or 


@ Move the cursor to the home line, type EDIT DECK (or EDID or 
EDIT), and press the carriage-return key. 


When a deck is selected for editing, PPE checks that the deck has 
been extracted to the level. If it has not, PPE extracts the deck 
if possible. PPE then begins an editor session. The text 
displayed is the source text of the deck with the compiler 
diagnostics inserted at the points in the text where the errors were 
detected. 

The first diagnostic is highlighted. As you correct errors in the 
source text, use the PPE the provided functions to delete the 
corresponding diagnostics and highlight the next diagnotics. The 
functions provided by PPE for deleting and highlighting diagnostics 
are DELETE IDENTICAL ERRORS, LOCATE NEXT ERROR, and 

SKIP LINE ERRORS. See chapter 4, PPE Quick Reference, for 
information about these functions. 


The following specialized PPE operations are available when editing 
source text with interwoven diagnostics: 


e Display the online manual explanation of a diagnostic. 
e Locate a diagnostic: 
e Locate the next diagnostic. 


e Locate the next source line containing diagnostics associated 
with it. 


@ Remove all diagnostics identical to the highlighted diagnostic. 


e Display the number of diagnostic messages remaining in the deck. 
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Use only the functions DELETE IDENTICAL ERRORS, LOCATE NEXT ERROR, 
and SKIP LINE ERRORS to change diagnostic itaea: If you change a 
diagnostic line by any other means, PPE may not recognize the the 
changed diagnostic line, and may not remove the line from your 
source. 


Displaying a Diagnostic Explanation 


The compiler online manual contains information that can help you 
correct compiler diagnostics. 


To display this information: 

1. Position the cursor on the diagnostic message to be explained. 
(If the cursor is not on a diagnostic message, the highlighted 
diagnostic message is explained.) 

2. Request the information by doing either of the following: 


e Press the function key labeled Assist, or 


@ Move the cursor to the home line, type EXPLAIN ERROR MESSAGE 
(or EXPEM or ASSIST),and press the carriage-return key. 


Locating Diagnostic Messages 
When PPE locates a diagnostic message, the diagnostic message is 
highlighted, positioning the cursor as close as possible to the 


error in the source that caused the diagnostic message. 


To locate and highlight the next diagnostic message and delete the 
currently highlighted diagnostic message, do either of the following: 


© Press the function key labeled NxtErr, or 


@ Move the cursor to the home line, type LOCATE NEXT ERROR, (or 
LOCNE, or NXTERR), and press the carriage-return key. 
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To remove all diagnostic messages associated with the same source 
line as the currently highlighted diagnostic message, position the 
cursor at the location of the next error, and highlight the 
associated diagnostic message: 


@ e Press the function key labeled Skip, or 
@ Move the cursor to the home line, type SKIP_LINE ERRORS (or 
SKILE, or SKIP), and press the carriage-return key. 
To delete all diagnostic messages identical to the highlighted 
diagnostic message: 
@ Press the function key labeled DellIE, or 


8 Move the cursor to the home line, type DELETE IDENTICAL ERRORS 
(or DELIE), and press the carriage-return key. 


Displaying the Diagnostic Message Count 


At any time during the editing session, you can display the number 
of diagnostic messages remaining in the deck. 


© To display the diagnostic message count for the deck: 


@ Move the cursor to the home line, type 
DISPLAY REMAINING ERROR COUNT (or DISREC), and press the 
carriage-~return key. 


Executing the Product 


After all compilation errors have been corrected and the product has 
been built successfully, the next step is to execute the product. 


The product can be run with varying parameter lists. If execution 
errors are found, it can be executed under control of the Debug 
utility to find the cause of the errors. You would then edit the 
source decks and rebuild the product before testing product 
execution again. 


If you have selected the Run Automatically option on the Tailor 
Options screen, the product is run after each successful build. 
Otherwise, you must initiate each run using the following procedure. 
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To run the product: 


1. Go to the Run Files screen. (The Run Files screen is 
automatically displayed after a successful build or after 
executing the RFiles function from the Deck List screen.) 


The Run Files screen appears similar to the following: 


Run file 1 thru 2 of 2 


RUN FILES 


Run purpose: X NORMAL __ INTERACTIVE DEBUG 


Run parameters: 


Run file 


SLOADMAP 
STERMINAL_OUTPUT 


Banner Tailor Export BProcs Delete PLists 
FI] Run |[F2 {Print [| F3jImport |F4]LLists|F5] Undo JF6] Quit |F7}EdiPL |F8/Stacks 


2. Select a Run purpose (NORMAL, INTERACTIVE DEBUG). Type a 
non-blank character before the selected purpose. 


3. Type the desired parameter list in the field under the label: 
Run parameters: 


When execution begins, PPE passes the parameter list to the 
starting procedure of the product. 


4. You may want to check that the correct program library list is 
specified on the Library Lists screen. (The DISPLAY LIBRARY 
LISTS command takes you to the Library Lists screen; using Back © 
returns you to the Run Files screen.) 
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You may also want to check and possibly change the current set 

of program attributes. For example, the default load map 

Options are none, in which case, no load information is written 

to the SLOADMAP file. 

To display the current program attribute set: 

a. Move the cursor to the home line, type 
DISPLAY PROGRAM ATTRIBUTES (or DISPA), and press the 
carriage-return key. 

b. After looking at the attribute display, press the 
carriage~return key to return to PPE. 

To display the program attribute parameters: 

ae Move the cursor to the home line, type 
DISPLAY COMMAND INFORMATION SET PROGRAM ATTRIBUTES (or DISCI 
SETPA), and press the carriage~return key. 

b. After looking at the parameter display, press the 
carriage~return key to return to PPE, 

To change the program attribute set: 

@ Move the cursor to the home line, type 
SET PROGRAM ATTRIBUTES (or SETPA) followed by the desired 
attribute parameters, and press the carriage~return key. 


For example, to change the load map options to all, type: 


@ set_program attributes, load _map options=all 


Request the run, by doing either of the following: 
@ Press the function key labeled Run, or 


@ Move the cursor to the home line, type RUN, and press the 
carriage-return key. 
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PPE loads the product from the object library, satisfying 
external references in the following order: 


e In the PPE object library at the current level. 
e In the PPE object libraries at higher levels of the hierarchy 


@ In the object libraries specified in the program library 
list entries on the Library Lists screen in the order listed. 


® In the object libraries listed in the job library list in 
the order listed. 


If the LOAD MAP OPTIONS program attribute is not NONE, PPE writes a 
load map to file $LOADMAP, which can be viewed later. 


After loading, product execution begins at the starting procedure 
specified on the Tailor Options screen. The product reads from its 
input files and writes to its output files, the same as it would 
outside of PPE. The only change is that anything written to SOUTPUT 
is also written to a file called $TERMINAL OUTPUT for later viewing. 


If the Run purpose is INTERACTIVE DEBUG, PPE executes the product 
under control of the Full-Screen Debug utility, using its 
full-screen interface. 


When you execute the Run function, PPE searches every object library 
in your hierarchy. The loader produces a warning level error 
message if it encounters an empty object library. Since PPE sets 
the initial termination error level for a job to WARNING, an empty 
library might cause your run to terminate prematurely. 


You can change the termination error level with the SCL 
SET PROGRAM ATTRIBUTES command. The recommended settings are 
WARNING and ERROR. The following lists the merits of each choice: 


ERROR An empty object library does not terminate a run. 
However, PPE does not inform you when any warning 
level error messages are produced, and the run might 
terminate unexpectedly. Also, you are not informed 
if an empty object library is encountered, even if 
none should be empty. 


WARNING Any WARNING level error message terminates a run. 


Therefore, an empty object library causes a run to 
terminate. 


Regardless of the termination error level setting for your job, all 
errors are written to the $LOADMAP file. 
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At run completion, all PPE files generated by the run are listed 
under the heading Run file. To view the contents of any of these 
files, perform these steps: 
1. Position the cursor on the file. 
2. Display the file text by doing either of the following: 

@ Press the function key labeled Edit, or 

@ Move the cursor to the home line, type EDIT RUN FILE (or 

EDIRF or EDIT), and press the carriage-return key. 

You can print any of the list files on the Run Files screen. To do 
so, perform the following steps: 
1. Position the cursor on the file. 
2. Request printing, by doing either of the following: 

® Press the function key labeled Print, or 

@ Move the cursor to the home line, type PRINT _RUN FILE (or 


PRIRF or PRINT), and press the carriage-return key. 


When PPE executes the PRINT RUN FILE command, it first attempts to 
execute an SCL command of the following form: 


PRINT lfn 
where lfn is the file path of the file to be printed. If no PRINT 


command exits, PPE executes the standard NOS/VE PRINT FILE command 
with default settings. 
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Transmitting Code 


After you have completed the testing of code at the lowest level of 
the environment catalog hierarchy, you are ready to transmit it to 
the next higher level of the hierarchy. 


Transmittal always moves the transmitted decks up one level in the 
hierarchy. It removes the transmitted decks from the source library 
at the lowest level of the environment catalog hierarchy and puts 
them in the source library at the next higher level. The code is 
then accessible to others whose PPE levels are linked to the higher 
level to which the code has been transmitted. 


If all decks to which a modification applies are transmitted, the 
modification can no longer be used at the lower level. To continue 
using the modification, you must extract at least one of the decks 
to which the modification applies. 


To transmit one or more decks: 

1. Go to the Deck List screen. If the Deck List screen is on the 
Screen stack, you can return there by using BACK one or more 
times. If not, you must go to the Environment Description 


screen or the Modification List screen and perform one of the 
following: 


@ Position the cursor on the SCU object DECKS and press the 
function key labeled SCUObj, or 


e Position the cursor on the SCU object DECKS and press the 
carriage-return key, or 


e Move the cursor to the home line, type 


DISPLAY SCU OBJECT LIST DECK (or DISSOL D or SCUOBJ D), and 
press the carriage-return key. 


2. Mark the decks to be transmitted (as described earlier under 
Marking Objects in a List). 


If you mark no decks, PPE transmits the deck under the cursor. 


3. Transmit the deck (or decks) by doing either of the following: 
® Press the function key labeled TraS, or 


@ Move the cursor to the home line, type TRANSMIT SOURCE (or 
TRAS), and press the carriage-return key. 
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To transmit a deck, PPE copies the deck and attempts to combine it 
with the source library at the next higher level of the hierarchy. 
If the deck is not already in the higher source library, PPE adds it 
to the library. If the deck is already in the higher source 
library, PPE checks whether the interlocks match. 


If the interlocks in the deck headers do not match, the deck 
transmittal fails. If the interlocks match, the lower deck replaces 
the higher deck having the same name. After the deck has been 
transmitted to the higher library, PPE deletes it from the lower 
library. 


File Cycle Management Within the Environment Catalog 


When you transmit source, a new high cycle of the source library 
within your environment catalog is created. The low cycles allow 
you to recover from catastrophic events. However, you can easily 
use up a large amount of file space. To avoid using excess file 
space, you should frequently delete the low cycles of your source 
library. You can use EDIT CATALOG from the home line of your 
environment catalog to do this. 


When you transmit source, the object modules in the lowest level of 
your environment catalog hierarchy that are built by that source 
should be deleted from the highest cycle of SOBJECT LIBRARY on the 
Build Files screen. The CREATE OBJECT LIBRARY utility can be used 
from the home line of the Build Files screen to do this. 


Also, after you transmit, notify the owner of the next higher level 
in your hierarchy to do a build using the transmitted decks. This 
keeps the SOBJECT LIBRARY at the higher level of the hierarchy up to 
date, incorporating your transmitted source code into the object 
code at that level. 


Changes made to the source library are not available to other tasks 
or PPE sessions at lower levels in the hierarchy until you exit the 
PPE session in which the changes occurred, or until the changed 
decks are transmitted to the next higher level in the hierarchy. 
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This chapter contains concise descriptions of PPE screens and PPE 
commands presented in alphabetical order for quick reference. 


PPE Screens 


This section describes all PPE screens in alphabetical order by 
Screen name. Each description lists the means of accessing the 
screen, the commands available from the screen, and the general 


appearance of the screen. 
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Banner 


Purpose: Displays the name, version, and level of PPE with the 
copyright notice and instructions for use. Also, this 
screen provides access to the online manual 
introduction to PPE. 


To access: Begin a PPE session, or 
Use DISPLAY BANNER (Banner or DISB) from any screen 
except the Screen Stack screen. 


Commands BACK TO PREVIOUS CONTEXT 
available: CLEAR SCREEN 
QUIT SAVE 


REQUEST HELP 


Display: 


Professional Programming Environment (PPE) 
Version 1.1 Level 87300 
COPYRIGHT CONTROL DATA 1987 
Press Next to proceed with the PPE session. 


Press Help to learn about the PPE. 
Press Quit (STOP) to exit the PPE. 


ol Jel IL dL Iosl__Jeclese el Tel] 
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Build Errors 


Purpose: Displays a list of decks which contain build errors and 
enables access to the decks for correction of their 
errors. 


To access: Execute a build that fails, or 
Use DISPLAY BUILD ERRORS (Errors or DISBE) from the 
Deck List screen. 


Commands BACK TO PREVIOUS CONTEXT 
available: BEGIN MARK 
CLEAR SCREEN 
DISPLAY BANNER 
DISPLAY BUILD PROCESSORS 
DISPLAY LIBRARY LISTS 
DISPLAY PARAMETER LIST LIBRARY 
DISPLAY SCREEN STACK 
DISPLAY TAILOR OPTIONS 
EDIT DECK 
EDIT PARAMETER LIST 
END_MARK 
EXTRACT SOURCE 
HOME CURSOR 
MOVE TO BOTTOM 
| MOVE TO FIRST 
MOVE TO LAST 
yd MOVE _TO_TOP 
PAGE BACKWARD 
PAGE FORWARD 
QUIT SAVE 
REMOVE MARK 
REQUEST HELP 
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Display: 


BUILD ERRORS Deck 1 thru 3 of 3 


Detected on 06/23/86 at 14:41 


Current modification: MY_MOD 


Deck Error Count 


ADD_ FORM 
DISPLAY_FORTRAN_PARMS 
PETSFORM_DISPLAY_TASK_SET 


UnMark Tailor 8Procs PLists EndMrk 
FIILLists|[F2jStack |F3iBanneriF4{ ExtS [FS F6 F71EdiPL | F8{] Mark 


Current modification: 
This field displays the name of the modification to which any 
editing changes made from this screen are assigned. You can 
change the field value by typing over the current value. 


If the specified modification does not exist at the lowest level 
of the PPE environment catalog hierarchy, you cannot edit any 
decks. You must choose a modification that exists at the lowest 
level of the hierarchy to edit a deck. 


Deck / Error Count: 
Lists the names of the decks in which errors were detected 
during the last build and the number of errors in each. You 
select the deck to be edited by positioning the cursor on the 
deck name. 


Build Files 


Purpose: Lists output files from the last build and allows 
viewing of their contents. 


To access: Use DISPLAY BUILD FILES (BFiles or DISBF) from the Deck 
List screen. 
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available: 


Display: 


Revision A 


BUILD FILES 
Build File 


SINPUT_SOURCE_MAP 
SOBJECT LIBRARY 

SPROCESSOR_INPUT 

SPROCESSOR OUTPUT 
SEXPAND_ERRORS 
ERROR _LYSTING 
SOURCE_LISTING 


BACK TO PREVIOUS CONTEXT 
CLEAR | SCREEN 

DELETE BUILD FILE 
DISPLAY BANNER 

DISPLAY BUILD PROCESSORS 
DISPLAY LIBRARY LISTS 
DISPLAY | PARAMETER _ LIST LIBRARY 
DISPLAY SCREEN STACK 
DISPLAY TAILOR OPTIONS 
EDIT BUILD FILE 

EDIT PARAMETER LIST 
EXPORT BUILD FILE 

HOME CURSOR 

IMPORT BUILD FILE 

MOVE TO BOTTOM 

MOVE _ TO | FIRST 

MOVE TO LAST 

MOVE TO TOP 

PAGE BACKWARD 

PAGE FORWARD 

PRINT BUILD FILE 

QUIT_ SAVE 

REQUEST_HELP 

UNDO_LAST DELETE 


Banner Tailor Export BProcs Delete Plists 
F1 F2iPrint {F3|Import |F4|LLists}FS| Undo |F6] Quit JF7/EdiPLs{F8j]Stack 


Build File 1 thru 7 of 7 


PPE Screens 
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Build File: 
Lists the names of the build files produced by the last 
successful build. (The build files produced are those selected 
by the parameter list used by the build.) You can also import 


build files to this list. @ 


You can delete, export, print, or view a build file in the list 
by positioning the cursor on the file name and executing the 
appropriate command. 


File cycles are not supported. When you delete a file, all 
cycles of the file are deleted. 


Build Processors 


Purpose: Displays the list of build processors supported by PPE 
and enables editing of the deck template and parameter 
list for each processor. 


To access: Use DISPLAY BUILD PROCESSORS (BProcs or DISBP) from any 
screen except the Banner and Screen Stack screens. 


Commands BACK TO PREVIOUS CONTEXT 
available: CHANGE , BUILD ) PROCESSOR 

CLEAR SCREEN 

DISPLAY BANNER @ 

DISPLAY LIBRARY LISTS 

DISPLAY _ PARAMETER . LIST LIBRARY 

DISPLAY _ SCREEN STACK 

DISPLAY ’ TAILOR | _ OPTIONS 

EDIT | DECK TEMPLATE 

EDIT ] ' PARAMETER . LIST 

HOME ; CURSOR 

QUIT SAVE 

REQUEST HELP 
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Display: 


BUILD PROCESSORS 


Processor 


COBOL 


AN CFORTRAN Version 2) 


Processor 
Lists the names of the build processors supported by PPE. The 
currently selected build processor for the PPE level is 
highlighted. It is the build processor that executes all 
subsequent builds. 


Each build processor has a deck template that can be used when 
creating decks. You can select the deck template to be edited 
by positioning the cursor on the build processor name. 


NOTE 


You can change the highlighted build processor using the 
CHANGE BUILD PROCESSOR command (or ChaBP key). However, it is not 
appropriate to change the build processor when the level already 
contains source code written for the previous build processor. 
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Deck Creation 


Purpose: Enables creation of a new deck. 


To access: Use CREATE DECK (Create or CRED) from the Deck List 
screene 


Commands BACK_TO PREVIOUS CONTEXT 
available: CLEAR_SCREEN — 
CREATE DECK 
DISPLAY BANNER 
DISPLAY SCREEN STACK 
EDIT DECK 
HOME CURSOR 
QUIT_SAVE 
REQUEST_HELP 


Display: 


DECK CREATION 


Creation modification: MY_MOD 
Name: Author: Fred Johnson 


Deck is expandable: X_ TRUE 


__FALSE 


Initial source: X_NONE DECK TEMPLATE 


File: 


Attributes: | CONTAINS DECK DIRECTIVES _ HAS MULTIPLE PARTITIONS 


Description: 


Banner 
Fi[CreatelF2 F3 F4 FS F6} Quit [F7 F8 
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Creation modification: 
Field containing the name of the creation modification for the 
deck. Any source text inserted in the deck when it is created 
is assigned to the creation modification. The default value is 
the currently selected modification. You can change the value 
by typing over it. 


If the specified modification does not exist at the lowest level 
of the PPE environment catalog hierarchy, the deck is not 
created. PPE issues an informative message and prompts you to 
acknowledge receipt of the message. 


If the specified modification does not exist at any level of the 
PPE environment catalog hierarchy, PPE asks whether you want the 
modification created with SCU default values (which do not use 
the Author value from the Tailor Options screen). If you say 
yes to the prompt, PPE creates the modification; otherwise, PPE 
does not create the modification. 


Name: 
Field in which you type the name of the new deck. The name must 
follow the rules for SCL names and must not match the name of 
any existing deck in the PPE hierarchy. PPE notifies you if the 
name is invalid when you use CREATE DECK or EDIT DECK to create 
the deck. 7 


Author: 
Field containing the value stored in the Author field of the 
deck header. The default value is the Author value from the 
Tailor Options screen. You can change the value by typing over 
it. 


Deck is expandable: 
Selects the expand attribute for the deck: TRUE for a deck that 
can be expanded directly, FALSE for a deck that is expanded only 
when it is copied by another deck. You select a value by typing 
a non-blank character by TRUE or FALSE. The default is TRUE. 


Initial source: 
The information under this heading describes the source text 
inserted in the deck when it is created. It can be NONE or the 
text of the deck template for the build processor or the text 
copied from a file. 


To select the deck template, type non-blank character in the 
field before DECK TEMPLATE. 


To specify a file of text, enter its file path in the space 


after File:. If you specify a file, you can also specify that 
it CONTAINS DECK DIRECTIVES or HAS MULTIPLE PARTITIONS. 
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If you select CONTAINS DECK DIRECTIVES, SCU processes any -._ 
directives embedded in the source text and thus, may create 
multiple decks. (The deck names are specified on the *DECK 
directives.) 


If you select HAS MULTIPLE PARITIONS, SCU converts each © 
end-of-partition delimiter to an embedded *WEOP directive and 

continues copying text until it reaches the end of the file. 
(Otherwise, it would stop copying text at the first 

end-of-partition delimiter.) 


Description: 
Field in which you can type an optional description of the deck 
contents to be stored in the deck header. The default for this 


field is BLANK. 


Deck List 


Purpose: Lists the decks available at this level so you can 
select decks for various commands. 


To access: Use DISPLAY SCU_ OBJECT LIST DECK (SCUObj D or DISSOL D) 
from the Environment Description or Modification List | 


screen. 
Commands BACK | TO ) PREVIOUS | CONTEXT 
available: BEGIN | MARK 


BULLD CHANGED DECKS 
BUILD DECKS 

CLEAR SCREEN 

CREATE DECK 

DELETE DECK 

DISPLAY BANNER 

DISPLAY BUILD ERRORS 

DISPLAY BUILD FILES 

DISPLAY BUILD PROCESSORS 
DISPLAY LIBRARY LISTS 
DISPLAY PARAMETER LIST LIBRARY 
DISPLAY RUN FILES — 

DISPLAY SCREEN STACK 

DISPLAY SCU_OBJECT LIST 
DISPLAY TAILOR OPTIONS 

EDIT DECK 

EDIT PARAMETER LIST 

END MARK 

EXTRACT SOURCE 

HOME CURSOR 

LOCATE DECK © 
LOWER DISPLAY CEILING 


MOVE | TO | BOTTOM 
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Commands MOVE _TO FIRST 
available: MOVE TO LAST 
(continued) MOVE TO TOP 
PAGE BACKWARD 
PAGE FORWARD 
@ QUIT SAVE 
RAISE DISPLAY CEILING 
REMOVE MARK 
REQUEST HELP 
TRANSMIT SOURCE 
UNDO LAST DELETE 


Display: 


Deck 1 thru 5 of 10 


DECK LIST 


SCU objects: DECKS MODIFICATIONS 


Current mod: MY_MOD Display ceiling: SYSTEM_TESTED 


Nearest residence 


Deck 


UNTESTED 
UNTESTED 
UNIT_TESTED 

SYSTEM TESTED 
UNIT_TESTED 


ADD FORM 
ADJUST_FORM_TO_FIT_SCREEN 
ADJUST MAIN 

ADJUST _PARM LISTS 

ASSIGN COMMON MENU ITEMS 


UnMark Build BFiles Tras Delete Locate Lower EndMrk 
FiiCreate [F2/Buid F3IRFiles|F4] ExtS | FS] Undo [F6] Quit |F7{Raise [F8] Mark 


SCU objects: 
Line listing the kinds of SCU objects that can be displayed. 


To go to the Modification List screen, position the cursor on 
MODIFICATIONS and press the carriage-return key. (If the 

Modification List screen is on the screen stack, PPE executes 
BACK TO PREVIOUS CONTEXT commands until the Modification List 


@ screen is displayed.) 


Display ceiling: 
Field displaying the level name of the current display ceiling. 
The display ceiling is the highest level of the PPE hierarchy 
whose decks are listed on the screen. You can change the 
@ display ceiling using the Raise and Lower functions. 
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Current mod: 


This field displays the name of the modification to which any 
editing changes made from this screen are assigned. You can 
change the field value by typing over the current value. 


If you change the Current mod: field value, you must choose a 
modification that exists at the lowest level of the hierarchy. 
PPE informs you if the specified modification does not exist at 
the lowest level of the environment catalog hierarchy, and you 


must choose another modification. 


Deck / Nearest Residence: 
List of decks in the PPE source libraries at or below the 
current display ceiling level. The Nearest Residence is the 
lowest PPE level that has a copy of the deck. You can select 
deck from the list by positioning the cursor on the deck name 
you can select decks by marking one or more ranges of decks. 


Environment Description 


Purpose: Displays information about your PPE level within the 
PPE hierarchy. 


To access: Press the carriage-return key at the Banner screen. 
Otherwise, use the Screen Stack or the BACK function 
key. 


Commands CHANGE DISPLAY CEILING 
available: CLEAR SCREEN 
DISPLAY BANNER 
DISPLAY BUILD PROCESSORS 
DISPLAY LIBRARY LISTS 
DISPLAY PARAMETER LIST LIBRARY 
DISPLAY SCREEN STACK 
DISPLAY _SCU_OBJECT_LIST 
DISPLAY TAILOR OPTIONS 
EDIT PARAMETER LIST 
HOME CURSOR 
IMPORT SOURCE LIBRARY 
MOVE TO BOTTOM 
MOVE TO FIRST 
MOVE TO LAST 
MOVE TO TOP 
PAGE BACKWARD 
PAGE FORWARD 
QUIT SAVE 
REQUEST _HELP 


4-12 Professional Programming Environment Revision A 


or 


PPE Screens 


Display: 


ENVIRONMENT DESCRIPTION 


SCU objects: DECKS MODIFICATIONS 


Hierarchy level name: UNTESTED 


This level is Linked to environment catalog: 


-PROJX .PROFESSIONAL_ ENVIRONMENT 


Build processor: FORTRAN 


Hierarchy level names 


SYSTEM_TESTED 


Banner Tailor BProcs LLists 
FI/LLists| F2 |SCUObj | F3}Import [F4{ChaDc | FS F6} Quit |F7JEdiPL [F8 [Stack 


SCU objects: 
Line listing the kinds of SCU objects that can be displayed. To 
go to the Deck List screen, position the cursor on DECKS and 
press the carriage-return key. To go to the Modification List 
Screen, position the cursor on MODIFICATIONS and press the 
carriage—return key. 


Hierarchy level name: 
Field in which you assign a name to your PPE level. The name 
must follow SCL naming rules and be unique in the PPE hierarchy. 


This level is linked to environment catalog: 
Field in which you may type the catalog path of a PPE catalog to 
which your PPE level is to be linked. Your PPE level becomes 
the lowest level in a hierarchy consisting of your PPE level, 
the specified PPE catalog, the catalog to which the specified 
catalog is linked (if any), and so forth up an arbitrary number 
of levels. 


Build processor: 
Field displaying the name of the build processor used by your 
PPE level. This field defaults to FORTRAN. You can change the 
name in this field by typing over it. 


Hierarchy level names: 
List of the level names in the PPE hierarchy with your PPE level 
name at the bottom. The current display ceiling is highlighted. 
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Library Lists 


Purpose: 


To access: 


Commands 
available: 


Displays and enables editing of these lists: the 
alternate source library list, the program library 
list, and the command list. 


Use DISPLAY LIBRARY LISTS (LLists or DISLL) from the 
Build Errors, Build Files, Build Processors, Deck List, 
Environment Description, Modification List, Run Files, 
and Tailor Options screens. 


BACK TO PREVIOUS CONTEXT 
CLEAR SCREEN 

DELETE LIST ENTRY 
DISPLAY BANNER 

DISPLAY BUILD PROCESSORS 
DISPLAY PARAMETER LIST LIBRARY 
DISPLAY SCREEN STACK 
DISPLAY TAILOR OPTIONS 
EDIT PARAMETER LIST 

HOME CURSOR 
INSERT LIST ENTRY 
MOVE TO BOTTOM 
MOVE TO FIRST 

MOVE TO LAST 

MOVE TO TOP 

PAGE BACKWARD 

PAGE FORWARD 

QUIT SAVE 

REQUEST HELP 

UNDO_LAST DELETE 


4-14 Professional Programming Environment Revision B 


PPE Screens 


Display: 


LIBRARY LISTS 


Alternate Source Libraries Entry 0 thru 0 of 0 
AL, I EE IIE EE IEE IE POISE IU ITE PT LDL TES IE TET TE PATS TIE LIED Ea I ST IT NIE RE a ELE i aE TES IES SIT OREO SE EM ES EY ET EES 


Program Library List entries Entry O thru 0 of 0 


Command List Entries Entry 0 thru O of O 


a aD 


Banner Tailor BProcs Delete PLists 
Fil Insert] F2 F3 F4 FS} Undo |F6] Quit [F7JEdiIPL JF8iStack 


Alternate Source Libraries: 
List of SCU source library files in the order the files are 
searched by a build. When a build expands a deck, it processes 
each copy directive in the deck by copying the specified deck 
into that location. The decks to be copied are searched for in 
this order: 


1. The source libraries in the PPE hierarchy, from lowest level 
to highest level. 


2. The source libraries in the Alternate Source Libraries 
list. These libraries are searched in the order presented 
in the list. 


Program Library List entries: 
List of object library files in the order that the files are 
searched by the loading process. When the product is loaded, 
its external references are satisfied by loading the modules 
containing the referenced entry points. The entry point search 
proceeds in this order: 


1. The object libraries in the PPE hierarchy, from lowest level 
to highest level. 


2. The program library list entries listed on this screen. 


3. The job library list entries. 
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Command List Entries: 
List of catalogs and object library files to be added as entries 
in the SCL command list. By adding the entries to the SCL 
command list, the entry points in the object libraries and the 
files in the catalogs can be executed as SCL commands during the 
PPE session. The entries are removed from the command list when © 


the PPE session ends. For more information on the command list, 
see the SCL Language Definition manual. 


Modification Creation 
Purpose: Enables creation of a new modification. 


To access: Use CREATE MODIFICATION (Create or CREM) from the 
Modification List screen. 


Commands BACK TO PREVIOUS CONTEXT 
available: CLEAR SCREEN 


CREATE MODIFICATION 
DISPLAY BANNER 


DISPLAY SCREEN STACK 
HOME CURSOR 

QUIT SAVE 
REQUEST_HELP 


Display: 6 


MODIFICATION CREATION 
Name: 
Author: Fred Johnson 


Descriptions 


Banner 
F1i Create] F2 F3 F4 F5 F6} Quit [F7 FBIStack 
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Name: 
Field in which you type the name of the new modification. The 
name must follow SCL naming rules and be unique within the PPE 
hierarchy. If you select a modification name that already exits 
in your hierarchy when you use CREATE MODIFICATION to create the 
© modification, PPE so informs you. You must then select a new 
name to create the modification. 


Author: 
Field containing the value stored in the Author field of the 
modification header. The default value is the Author value from 
the Tailor Options screen. You can change the value by typing 
over it. 


Description: 
Field in which you can type an optional description of the 
purpose of the modification. The description is stored in the 
modification header. 


Modification List 


Purpose: Lists the available modifications. 


To access: Use DISPLAY SCU_OBJECT LIST MODIFICATION (SCUObj M or 
DISSOL M) from the Environment Description or Deck List 


@ screen. 


Use BACK TO PREVIOUS CONTEXT from the Modification 
Creation screen. 


Commands BACK TO PREVIOUS CONTEXT 
available: BEGIN | MARK 
CHANGE CURRENT MODIFICATION 
CLEAR SCREEN 
CREATE MODIFICATION 
DELETE MODIFICATION 
DISPLAY BANNER 
DISPLAY BUILD FILES 
DISPLAY BUILD PROCESSORS 
DISPLAY LIBRARY LISTS 
DISPLAY PARAMETER LIST LIBRARY 
DISPLAY RUN FILES — 
DISPLAY SCREEN STACK 
DISPLAY SCU_OBJECT_ LIST 
DISPLAY TAILOR OPTIONS 
EDIT PARAMETER LIST 
END MARK 
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Commands HOME CURSOR 
available: | LOCATE MODIFICATION 
(Continued) LOWER DISPLAY CEILING 
MOVE TO BOTTOM 
MOVE TO FIRST 
MOVE TO LAST 
MOVE TO TOP 
PAGE BACKWARD 
PAGE FORWARD 
QUIT _SAVE 
RAISE DISPLAY CEILING 
REMOVE MARK 
REQUEST HELP 
UNDO LAST DELETE 


Display: 


Modification 0 thru 0 of O 


MODIFICATION LIST 


SCU objects: DECKS MODIFICATIONS 


Display ceiling: FRED 


Current mod: 


residence 


Nearest 


UnMark Tailor BFiles} BProcs Delete Locate Lower EndMrk 
F1j/Create | F2|SCUObj| F3|RFiles|F4/ChaCM | F5| Undo |F6] Quit |F7|Raise |F8} Mark 
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SCU objects: 


Line listing the kinds of SCU objects that can be displayed. To 
go to the Deck List screen, position the cursor on DECKS and 
press the carriage-return key. 


r Display ceiling: 


Field displaying the level name of the display ceiling. The 
display ceiling is the highest level of the PPE hierarchy whose 
modifications are listed on the screen. You can change the 
display ceiling by typing over the value in this field. 


Current mod: 


Mod 


Field displaying the name of the currently selected 
modification. You can change the field value by typing over the 
current value. 


If the specified modification does not exist at the lowest level 
of the PPE environment catalog hierarchy, PPE issues a message 
informing you of this. You must specify a modification that 
resides at the lowest level of the hierarchy. 


/ Nearest Residence: 

List of modifications in the source libraries in the PPE 
hierarchy up through the display ceiling level. The Nearest 
Residence is the lowest PPE level in which the modification is 
defined. You can select a modification from the list by 
positioning the cursor on the modification name or you can can 
select more than one modification by marking ranges of names in 
the list. 
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Parameter List 


Purpose: Enables viewing and editing of a parameter list for the 


current build processor. 


To access: Use CREATE PARAMETER LIST (Create or CREPL) from the 
Parameter List Library screen. 


Use EDIT PARAMETER LIST (Edit or EDIPL) from the 
Parameter List Library, Tailor Options, Build 
Processor, or Environment Description screens. 


Commands BACK TO PREVIOUS CONTEXT 
available: CHANGE ' TO | DEFAULT 

CLEAR SCREEN 

DISPLAY BANNER 

DISPLAY | "PARAMETER _ LIST LIBRARY 

DISPLAY | SCREEN | STACK 

EDIT PARAMETER LIST 

HOME CURSOR 

MOVE TO BOTTOM 

MOVE ° TO - ) FIRST 

MOVE TO | LAST 

MOVE | TO" TOP 

PAGE | ~ BACKWARD 

PAGE _ - FORWARD 

QUIT | " SAVE 

REQUEST HELP 


Display: 


PARAMETER LIST Parameter 1 thru 17 of 20 


DEBUG List for FORTRAN CFORTRAN Version 1) 


Par ameter Current Value 


SPROCESSOR INPUT 
SPROCESSOR OUTPUT 


INPUT 
BINARY OBJECT 

LIST 

COMPILATION DIRECTIVES 
~ DEBUG_AIDS 

DEFAULT COLLATION 
ERROR 


ERROR_LEVEL 
EXPRESSION_EVALUATION 


__USER X FIXED 


~_CANONICAL | __MAINTAIN __ EXCEPTIONS 
__MAINTAIN __ PRECISION _REFERENCE xX! NONE 
~_OVERLAPPING __STRING _! ~ MOVE 
_ON X OFF 
input_source_map 


FORCED_SAVE 
INPUT _SOURCE_MAP 


LIST_OPTIONS 
MACHINE_DEPENDENT 
ONE_TRIP_DO 
OPTIMIZATION LEVEL 
OPTIMIZATION OPTIONS 
RUNTIME CHECKS 


Banner PLists 
F1 Fe F3 ‘FS FS F6 F7IEdiIPL {F8 


X DEBUG LOW HIGH 
__INSTRUCTION _ SCHEDULING X NONE 
XR XS _NONE 
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Parameter / Current Value: 
Lists the parameter names and current parameter values. The 
file name is shown for file parameters; the available options 
are listed for option parameters. To select an option, type a 
& non-blank character in the blank before the option. 


To read about a parameter and its options, position the cursor 
on the parameter and use the REQUEST HELP command. 


File paths can be specified relative to the build files catalog 


of the PPE level or as the complete path. For example, the file 
path for a file in your master catalog would begin with SUSER or 
the family name (such as :NVE). 


Because PPE must control the input and output files generated 
during a build, it defines the following special files for its 
use: 


SINPUT SOURCE MAP 


PPE requires that each deck expansion write to this file the 
information required for mapping build errors to deck text 


and to provide for Full-Screen Debugging. Only specify 
SINPUT SOURCE MAP for the INPUT SOURCE MAP parameter. 


SPROCESSOR_INPUT 


PPE writes the source text expanded from decks to this file 
© and then requires that the file be the input file to the 
build processor. 


SPROCESSOR OUTPUT 
PPE requires that the build processor write its object 


modules to this file so that it can then combine the modules 
with the SOBJECT LIBRARY file at this level. 
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The files created by the run are created relative to the run 
subcatalog. You can copy files to the run subcatalog and copy 
files from the run subcatalog using IMPORT RUN FILE and 


EXPORT RUN FILE, respectively. 


PPE does not support cycles. When you delete a file, all cycles © 
are deleted. 


Screen Stack 


Purpose: Enables direct access to any PPE screen in the stack. 


To access: Use DISPLAY SCREEN STACK (Stack or DISSS) from any 
screen except the Banner screen. 


Commands BACK TO CONTEXT 
available: BACK TO PREVIOUS CONTEXT 
CLEAR _SCREEN 
MOVE _TO FIRST 

MOVE_TO BOTTOM 

MOVE _TO LAST 
MOVE_TO_ TOP 
PAGE BACKWARD 
PAGE FORWARD 
QUIT_SAVE 


REQUEST HELP @ 


Display: 


SCREEN STACK 


ENVIRONMENT DESCRIPTION 
DECK LIST 
RUN FILES 
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The list of screen names shows the path you have taken through the 
hierarchy of PPE screens. The first name is the screen at the top 
of the hierarchy; the last name is that of the screen displayed 
before the Screen Stack. 


Tailor Options 


Purpose: Enables viewing and selection of the default options 
for PPE operations. 


To access: Use DISPLAY TAILOR OPTIONS (Tailor or DISTO) from any 
Screen except the Banner screen and the Screen Stack 
screen. 


Commands BACK TO PREVIOUS CONTEXT 
available: CLEAR _ SCREEN 
DISPLAY _ BANNER 
DISPLAY _ BUILD PROCESSORS 
DISPLAY _ LIBRARY _ LISTS 
DISPLAY | PARAMETER _ LIST LIBRARY 
DISPLAY | _SCREEN | STACK 
EDIT PARAMETER _ _ LIST 
HOME CURSOR 
QUIT SAVE 
REQUEST HELP 


@ Display: 


TAILOR OPTIONS 


Author: FJ626 


Interlock value: FJ626 


Build defaults: 
Build processor: FORTRAN 


Run automatically after build: 
Run defaults: 

Starting procedure: 

Run purpose: X_ NORMAL __INTERACTIVE DEBUG 


_YES X_NO 


Delete Protection: 


X_ON __OFF 
Editing defaults: 
User prolog: 

PPE editor key assignments: _ BEFORE USER X AFTER USER — NONE 


Banner BProcs PLists 
FIlLLists |F2 F3 F4 FS F6| Quit [F7/EdiPL | F8IStack 
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Author: 
Field containing the default author value stored in deck and 


modification headers. The initial value is your user name. You 
can change the value by typing over it. 


Interlock value: 
Field containing the value stored as the interlock value when 
you extract a deck. The initial value is your user name. You 
can change the value by typing over it. 


Build defaults: 


These fields contain default values used when building the 
product. 


Build processor: 
The name of the build processor. It can be COBOL, CYBIL, 
FORTRAN, or VECTOR FORTRAN. You can change the build processor 
by typing over the existing name, striking out all of its 
characters. 


Run automatically after build: 
Option that determines whether PPE executes the product 
immediately after it builds it. The initial value is NO. To 
select YES, type a non-blank character in the field before YES. 


Run defaults: 
These fields contain default values used when executing the 
product. 


Starting procedure: 
Name of the entry point at which PPE is to begin product 
execution. The default is the same as the default outside of 
PPE, that is, the last transfer symbol loaded. All characters, 
including leading, embedded, and trailing blanks, are 
significant in this field. 


Run purpose: 
Indicates the default value determining how the product should 
be executed. (It can be changed for each run.) 


NORMAL Execute without control by the Full Screen 
Debug utility. 


INTERACTIVE DEBUG Execute under control of the Debug 
utility. The product must have been built 
with the debug options in its parameter 
list. The debug options are: 


OPTIMIZATION LEVEL=DEBUG 


DEBUG AIDS=DT 
INPUT SOURCE MAP=$INPUT SOURCE MAP 
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Delete protection: 


Allows you to select delete protection. Delete protection warns 
you when objects are about to be physically deleted. Options 
are: 


ON PPE issues a warning before physically deleting an 
object. You can then veto or confirm the deletion of the 
object. PPE defaults to ON. 


OFF PPE physically deletes objects without allowing you to 
veto the action. 


When you use a DELETE command (for example, DELETE DECK), the 
deleted object is logically deleted. This means that the name 
of the object is removed from the screen, but the object is 
still physically resident in PPE. Logically deleted objects can 
be recovered with the UNDO LAST DELETE command. 


A logically deleted object becomes physically deleted if: 


® Delete protection is ON and you confirm the deletion. The 
Delete protection warning is displayed when you attempt to 
leave the current screen, execute a command on the home 
line, or execute a command that might reference a logically 
deleted object. 


@ You exit PPE. When you exit PPE, all logically deleted 
objects become physically deleted. The delete protection 
warning is not displayed even if you selected Delete 
protection from the Tailor Options screen. 


e Delete protection is OFF and you leave the current screen, 
execute a command on the home line, or execute a command 
that might reference a logically deleted object. No 
deletion warning is displayed and you cannot veto the 
deletion. 


A physically deleted object cannot be recovered by invoking the 
UNDO LAST DELETE command. PPE can physically delete only 
objects that are logically deleted. 


Editing defaults: 


Fields for specifing an editor prolog to define the editor 
function keys when you enter the PPE editor. In addition to 
specifying the editor prolog, you can tell PPE to assign PPE 
commands to editor function keys before or after executing the 
editor prolog or you can tell PPE not to assign commands to any 
function keys. 
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The Editing defaults: fields are the following: 


User prolog: 
To define PPE editor function keys using an editor prolog, 
enter the file path of the editor prolog in the User 
prolog: field. For example, to define PPE editor function r 
keys using the editor prolog, C721 EDITOR PROLOG, type the 
following file path in the User Prolog: field: 


Suser.c721 editor prolog 


If you do not specify an editor prolog in this field, PPE 
uses the editor prolog, SCU EDITOR PROLOG, to define the 
editor function keys. If the file, SCU EDITOR PROLOG, does 
not exist, PPE defines the editor function keys using the 
standard function key definitions. 


PPE editor key assignments: 
To tell PPE how to assign PPE commands to editor function 
keys place a non-blank character in one of the following 
fields: 


BEFORE USER Causes PPE to assign PPE commands to the 
editor function keys before executing your 
editor prolog. First PPE assigns PPE 
commands to the editor function keys, then 
the editor prolog assigns commands to the 
function keys. @ 


AFTER USER Causes PPE to assign PPE commands to the 
editor function keys after executing your 
editor prolog. First the editor prolog 
assigns commands to the the function keys, 
then PPE assigns PPE commands to the keys. 


NONE Causes PPE to not assign any PPE commands to 
the editor function keys. 


When you choose BEFORE USER or AFTER USER, both PPE defined 
and user defined function keys are specified for the PPE 
editor. Any function key defined by both your user prolog 
and by PPE commands assumes the definition assigned to the 
key last. Therefore, to use your editor prolog with the PPE 
editor prolog to maximum effect, do the following: 


@ Determine which function keys are assigned PPE commands. 


e Define your editor prolog only for function keys not 


assigned PPE commands. @ 
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e Specify the file path of your editor prolog on the User 
prolog: field (the editor prolog can be any file 
containing EDIT FILE function key definitions). 


e Choose BEFORE USER or AFTER USER on the PPE editor key 
assignments: field. 


PPE Commands 


This section contains individual descriptions of the PPE commands, 
presented in alphabetical order by command name. Each description 
gives the following information: 


® The purpose of the command. 
e The PPE screen from which the command is available. 


e The function key label if your terminal has a function key for 
the command. 


@ The format of the command. 


The command format lists the command name and parameters as they 
would be typed on the home line of a PPE screen. The format gives 
the full and abbreviated names for the command and lists the command 
parameters. The last parameter of every command is its STATUS 
parameter. Individual descriptions are given for each parameter 
except the STATUS parameter. 


The STATUS parameter on PPE commands is the same standard STATUS 
parameter available on all NOS/VE SCL commands. Its use is 
optional. If you specify the name of an SCL status variable on the 
STATUS parameter of a command, the completion status of the command 
is stored in the status variable and execution continues with the 
next command received. To see the completion status stored in the 
status variable, you must display the variable. An SCL statement 
can also reference the contents of a status field. For more 
information on SCL status variables, see the SCL Language Definition 
manual. 


Note that changes made to the source library are not available to 
other tasks or PPE seesions at lower levels in the hierarchy until 
you exit the PPE session in which the changes occurred, or until the 
changed decks are transmitted to the next higher level in the 
hierarchy. 
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Display: 


PARAMETER LIST LIBRARY 


Parameter List 1 thru 3 of 3 


Processor: FORTRAN CFORTRAN Version 1) 


Parameter List 


SOA OE A BAI TI TI IE LT I I I LE IEE ETL OLLE TED, 


DEFAULT 
PRODUCTION 


Banner Delete 
Fi[Create|F2 F3 F4iGlobal {F51 Undo | F6} Quit | F7}EdiPL | F8i Banner 


Parameter List: 
List of parameter lists stored in the parameter list library for 
the build processor. The global parameter list is highlighted. 
The global parameter list is used in subsequent builds. 


PPE provides the following parameter lists: 
DEBUG Produces code for use with Debug. 
DEFAULT Uses processor default values for most parameters. 


PRODUCTION Produces code for production use. 
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Run Files 


Purpose: 


To access: 


Commands 
available: 


Enables execution of the product and viewing of the 
resulting run files. 


Execute a successful build, or 
Use DISPLAY RUN FILES (RFiles or DISRF) from the Deck 
List or Modification List screens. 


BACK TO PREVIOUS CONTEXT 
CLEAR SCREEN 
DELETE RUN FILE 

DISPLAY BANNER 

DISPLAY BUILD PROCESSORS 
DISPLAY LIBRARY LISTS 
DISPLAY PARAMETER LIST LIBRARY 
DISPLAY SCREEN STACK 
DISPLAY TAILOR OPTIONS 
EDIT PARAMETER LIST 

EDIT RUN FILE 
EXPORT RUN FILE 

HOME CURSOR 

IMPORT RUN FILE 

MOVE_TO BOTTOM 
MOVE TO FIRST 

MOVE TO LAST 

MOVE TO TOP 

PAGE BACKWARD 

PAGE FORWARD 
PRINT RUN FILE 

QUIT SAVE 

REQUEST HELP 

RUN 

UNDO LAST DELETE 
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Display: 


RUN FILES Run file 1 thru 2 of 2 


Run purpose: X_ NORMAL __ INTERACTIVE DEBUG 


Run parameters: 


Run File 


SLOADMAP 
STERMINAL_OUTPUT 


Banner Tailor Export BProcs Delete PLists 
FI} Run FF2tPrint [F3]Import |F4{LLists|F5] Undo IF6] Quit [F7FEdIPL [F8IStack 


Run purpose: 
Indicates how the product should be executed: 


NORMAL Execute without control by the Debug 


INTERACTIVE DEBUG Execute under control of the Debug 
utility. The product must have been built 


with the debug options specified in its 
parameter list. The debug options are: 


OPTIMIZATION LEVEL=DEBUG 
DEBUG_AIDS=DT 
INPUT SOURCE MAP=$INPUT_SOURCE_MAP 


Run parameters: 
Lists the parameters PPE passes to the starting procedure of the 
product. 


& Run File: 
‘Lists the files produced by the last run. It may include a load 
map file (SLOADMAP) and any output written to SOUTPUT 
($TERMINAL OUTPUT) . 
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The files created by the run are created relative to the run 
subcatalog. You can copy files to the run subcatalog and copy 
files from the run subcatalog using IMPORT RUN FILE and 
EXPORT RUN FILE, respectively. 


PPE does not support cycles. When you delete a file, all cycles © 
are deleted. 


Screen Stack 


Purpose: Enables direct access to any PPE screen in the stack. 


To access: Use DISPLAY SCREEN STACK (Stack or DISSS) from any 
screen except the Banner screen. 


Commands BACK TO CONTEXT 
available: BACK TO PREVIOUS CONTEXT 
CLEAR_SCREEN 

MOVE TO FIRST 
MOVE TO BOTTOM 

MOVE TO LAST 
MOVE TO_TOP 
PAGE BACKWARD 
PAGE FORWARD 
QUIT SAVE 


REQUEST HELP ® 


Display: 


SCREEN STACK 


ENVIRONMENT DESCRIPTION 
DECK LIST 
RUN FILES 


4-26 Professional Programming Environment Revision A 


PPE Screens 


The list of screen names shows the path you have taken through the 
hierarchy of PPE screens. The first name is the screen at the top 
of the hierarchy; the last name is that of the screen displayed 
before the Screen Stack. 


Tailor Options 


Purpose: Enables viewing and selection of the default options 
for PPE operations. 


To access: Use DISPLAY TAILOR OPTIONS (Tailor or DISTO) from any 
Screen except the Banner screen and the Screen Stack 
screen. 


Commands BACK TO PREVIOUS CONTEXT 
available: CLEAR SCREEN 
DISPLAY BANNER 
DISPLAY BUILD PROCESSORS 
DISPLAY LIBRARY LISTS 
DISPLAY PARAMETER LIST LIBRARY 
DISPLAY SCREEN STACK 
EDIT PARAMETER LIST 
HOME CURSOR 
QUIT SAVE 
REQUEST HELP 


Display: 


TAILOR OPTIONS 


FJ626 


Author: 


Interlock value: FJ626 


Build defaults: 
Build processor: FORTRAN 


Run automatically after build: YES X_NO 
Run defaults: 

Starting procedure: 

Run purpose: X_ NORMAL __INTERACTIVE DEBUG 


OFF 


Delete Protection: X_ON 


Editing defaults: 
User prolog: 
PPE editor key assignments: | BEFORE USER X AFTER USER 


_NONE 


Banner BProcs PLists 
FIjLLists{F2 F3 F4 F5 F6] Quit |F7[EdiPL | F8/[ Stack 
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Author: 
Field containing the default author value stored in deck and 
modification headers. The initial value is your user name. You 
can change the value by typing over it. 


Interlock value: 
Field containing the value stored as the interlock value when 
you extract a deck. The initial value is your user name. You 
can change the value by typing over it. 


Build defaults: 
These fields contain default values used when building the 
product. 


Build processor: 
The name of the build processor. It can be COBOL, CYBIL, 
FORTRAN, or VECTOR FORTRAN. You can change the build processor 
by typing over the existing name, striking out all of its 
characters. 


Run automatically after build: 
Option that determines whether PPE executes the product 
immediately after it builds it. The initial value is NO. To 
select YES, type a non-blank character in the field before YES. 


Run defaults: 
These fields contain default values used when executing the 
product. 


Starting procedure: 
Name of the entry point at which PPE is to begin product 
execution. The default is the same as the default outside of 
PPE, that is, the last transfer symbol loaded. All characters, 
including leading, embedded, and trailing blanks, are 
significant in this field. 


Run purpose: 
Indicates the default value determining how the product should 
be executed. (It can be changed for each run.) 


NORMAL Execute without control by the Full Screen 
Debug utility. 


INTERACTIVE DEBUG Execute under control of the Debug 
utility. The product must have been built 
with the debug options in its parameter 
list. The debug options are: 


OPTIMIZATION LEVEL=DEBUG 


DEBUG_AIDS=DT 
INPUT SOURCE MAP=$INPUT SOURCE MAP 
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Delete protection: 


Allows you to select delete protection. Delete protection warns 
you when objects are about to be physically deleted. Options 
are: 


ON PPE issues a warning before physically deleting an 
object. You can then veto or confirm the deletion of the 
object. PPE defaults to ON. 


OFF PPE physically deletes objects without allowing you to 
veto the action. 


When you use a DELETE command (for example, DELETE DECK), the 
deleted object is logically deleted. This means that the name 
of the object is removed from the screen, but the object is 
still physically resident in PPE. Logically deleted objects can 
be recovered with the UNDO LAST DELETE command. 


A logically deleted object becomes physically deleted if: 


e Delete protection is ON and you confirm the deletion. The 
Delete protection warning is displayed when you attempt to 
leave the current screen, execute a command on the home 
line, or execute a command that might reference a logically 
deleted object. 


e You exit PPE. When you exit PPE, all logically deleted 
objects become physically deleted. The delete protection 
warning is not displayed even if you selected Delete 
protection from the Tailor Options screen. 


e Delete protection is OFF and you leave the current screen, 
execute a command on the home line, or execute a command 
that might reference a logically deleted object. No 
deletion warning is displayed and you cannot veto the 
deletion. 


A physically deleted object cannot be recovered by invoking the 
UNDO LAST DELETE command. PPE can physically delete only 
objects that are logically deleted. 


Editing defaults: 


Fields for specifing an editor prolog to define the editor 
function keys when you enter the PPE editor. In addition to 
specifying the editor prolog, you can tell PPE to assign PPE 
commands to editor function keys before or after executing the 
editor prolog or you can tell PPE not to assign commands to any 
function keys. 
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The Editing defaults: fields are the following: 


User prolog: 
To define PPE editor function keys using an editor prolog, 
enter the file path of the editor prolog in the User 
prolog: field. For example, to define PPE editor function 
keys using the editor prolog, C721 EDITOR PROLOG, type the 
following file path in the User Prolog: field: 


Suser.c72l_ editor _prolog 


If you do not specify an editor prolog in this field, PPE 
uses the editor prolog, SCU EDITOR PROLOG, to define the 
editor function keys. If the file, SCU_EDITOR PROLOG, does 
not exist, PPE defines the editor function keys using the 
standard function key definitions. 


PPE editor key assignments: 
To tell PPE how to assign PPE commands to editor function 
keys place a non-blank character in one of the following 
fields: 


BEFORE USER Causes PPE to assign PPE commands to the 
editor function keys before executing your 
editor prolog. First PPE assigns PPE 
commands to the editor function keys, then 
the editor prolog assigns commands to the 
function keys. & 


AFTER USER Causes PPE to assign PPE commands to the 
editor function keys after executing your 
editor prolog. First the editor prolog 
assigns commands to the the function keys, 
then PPE assigns PPE commands to the keys. 


NONE Causes PPE to not assign any PPE commands to 
the editor function keys. 


When you choose BEFORE USER or AFTER USER, both PPE defined 
and user defined function keys are specified for the PPE 
editor. Any function key defined by both your user prolog 
and by PPE commands assumes the definition assigned to the 
key last. Therefore, to use your editor prolog with the PPE 
editor prolog to maximum effect, do the following: 


e Determine which function keys are assigned PPE commands. 


e Define your editor prolog only for function keys not 


assigned PPE commands. @ 
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e Specify the file path of your editor prolog on the User 
prolog: field (the editor prolog can be any file 
containing EDIT FILE function key definitions). 


e Choose BEFORE USER or AFTER USER on the PPE editor key 
assignments: field. 


PPE Commands 


This section contains individual descriptions of the PPE commands, 
presented in alphabetical order by command name. Each description 
gives the following information: 


e The purpose of the command. 
e The PPE screen from which the command is available. 


@ The function key label if your terminal has a function key for 
the command. 


e The format of the command. 


The command format lists the command name and parameters as they 
would be typed on the home line of a PPE screen. The format gives 
the full and abbreviated names for the command and lists the command 
parameters. The last parameter of every command is its STATUS 
parameter. Individual descriptions are given for each parameter 
except the STATUS parameter. 


The STATUS parameter on PPE commands is the same standard STATUS 
parameter available on all NOS/VE SCL commands. Its use is 
optional. If you specify the name of an SCL status variable on the 
STATUS parameter of a command, the completion status of the command 
is stored in the status variable and execution continues with the 
next command received. To see the completion status stored in the 
status variable, you must display the variable. An SCL statement 
can also reference the contents of a status field. For more 
information on SCL status variables, see the SCL Language Definition 
manual. 


Note that changes made to the source library are not available to 
other tasks or PPE seesions at lower levels in the hierarchy until 
you exit the PPE session in which the changes occurred, or until the 
changed decks are transmitted to the next higher level in the 
hierarchy. 
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BACK_TO_CONTEXT 


Purpose : 
Available 
from: 


Function 
key: 


Format: 


Remarks: 


Pops the screen stack to display the PPE screen under 
the cursor. 


Screen Stack screen. 


BacTC 


BACK TO CONTEXT or BACTC 
STATUS=status_ variable 


e All screens after the selected screen are removed 
from the stack. For example, if you select the 
second entry in the stack, the third and all 
subsequent entries are removed from the stack. 


BACK_TO_PREVIOUS_CONTEXT 


Purpose: 


Available 
from: 


Function 
key: 


Format: 


Revision A 


Returns to the preceding screen on the screen stack. 


Any screen except the Environment Description screen. 
Back 


BACK TO PREVIOUS CONTEXT or BACTPC or BACK 
STATUS=status_ variable 
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BEGIN_MARK 


Purpose: 


Available 
from: 


Function 
key: 


Format: 


Marks the first object in a range of selected objects. 
The last object in the range is marked using END MARK. 
The marked range of objects is then referenced by 
subsequent commands (such as DELETE DECK or 

EXTRACT SOURCE). 


The Build Errors, Deck List, and Modification List 
screens. 


Mark 


BEGIN MARK or BEGM or MARK 
STATUS=status variable 


BUILD_CHANGED_DECKS 


Purpose: 


Available 
from: 


Function 
key: 


Format: 


Remarks: 


Builds all expandable decks that have changed since the 
last build. 


Deck List screen or a Full-Screen Editor session 
that originates from within the Deck List or Deck 
Creation screens. 


Build 


BUILD CHANGED DECKS or BUICD or BUILD 
STATUS=status variable 


@ PPE considers a deck to have changed if it or any 
deck it references resides at the lowest level of 
your environment catalog hierarchy, and has been 
edited since the last build. 


@ When executed during an editing session, this 
command leaves the Full-Screen Editor, returns to 
the Deck List screen, and executes the build from 
there. 


e For more information about builds, see the Remarks 
in the BUILD DECKS command description. 
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BUILD_DECKS 


Purpose: 


Available 
from: 


Function 
key: 


Format: 


Remarks: 


Revision A 


Builds each selected deck (if the deck is expandable). 


Deck List screen. 


BuiD 


BUILD DECKS or BUID 
STATUS=status_ variable 


e PPE sets the working catalog to the build 
subcatalog during the build. 


e The input and output files for the build processor 
are specified by its parameter list. The parameter 
list used for the build is the global parameter 
list highlighted on the Parameter List Library 
screen. 


e The default input file for for the build processor 
is SPROCESSOR_INPUT. PPE directs SCU to write the 
expanded source to the input file. 


@ The default output file for the build processor is 
SPROCESSOR OUTPUT. PPE combines the object modules 
written to the output file with the object library 
at this level. 


@ The default source map file is $INPUT SOURCE MAP. 
The information that the deck expansion writes to 
the source map file allows for insertion of the 
build diagnostics into the source text at the 
points the errors were detected. This information 
is also used for displaying the source under 
control of the full-screen debugger. 


e If the build fails due to processor errors, PPE 
displays the Build Errors screen. 


© If the build fails due to SCU errors, PPE displays 
the Build Files screen. The file $SEXPAND ERRORS 
can be examined for the errors that caused the 
failure. 


e If the build succeeds, PPE displays the Run Files 
screen; it also runs the product if you have 
selected the Run automatically after build option 
on the Tailor Options screen. 
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CHANGE_BUILD_PROCESSOR 


Purpose: Selects the build processor used in all subsequent 
builds. 

Available Build Processors screen. 

from: 

Function ChaBP 

key: 

Format: CHANGE BUILD PROCESSOR or CHABP 


PROCESSOR=name 
STATUS=status variable 


Parameter: PROCESSOR or P 
Name of the selected build processor. The valid names 
are COBOL, CYBIL, FORTRAN, or VECTOR FORTRAN, 


If this parameter is omitted, the build processor under 
the cursor is selected. 


Remarks: e The currently selected build processor is 
highlighted on the screen. 


e The selected build processor is used for all 
subsequent builds and so it must be an appropriate 
processor for the source code at the level for 
which PPE is executed. For example, it would not 
be appropriate to specify COBOL as the build 
processor when the source code to be compiled is 
FORTRAN source code. 
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CHANGE_CURRENT_MODIFICATION 


Purpose: 


Available 
from: 


Function 
key: 


Format: 


Parameter: 


Remarks: 


Selects the modification used by subsequent edit 
sessions. 


Modification List screen. 
ChaCM 


CHANGE CURRENT MODIFICATION or CHACM 
MODIFICATION NAME=name 
STATUS=status_ variable 


MODIFICATION NAME or MN 
Name of the selected modification. The 
modification names are listed on the screen. If 
you omit this parameter, the modification under the 
cursor is selected. 


@ The modification must exist at the bottom level of 
the hierarchy. In other words, it must be a new 
modification or a modification that applies to a 
deck existing at this level. If necessary, extract 
a deck to which the modification applies using 
EXTRACT SOURCE. 


CHANGE_DISPLAY_CEILING 


Purpose: 
Available 
from: 


Function 
key: 


Format: 


Parameter: 


Remarks: 


Revision A 


Selects the highest PPE level whose content is included 
in displayed lists. 


Environment Description screen. 
ChaDC 


CHANGE DISPLAY CEILING or CHADC 
LEVEL NAME=name 
STATUS=status variable 


LEVEL NAME or LN 
Name of the selected PPE level. The level names 
are listed on the screen. If you omit this 
parameter, the level under the cursor is selected. 
If the cursor is not positioned on a level name, 
PPE prompts for the level name. 


e The display ceiling is highlighted in the list of 
Hierarchy Level Names. 
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CHANGE_GLOBAL_PARAMETER_LIST 


Purpose: Selects the parameter list under the cursor as the 
global parameter list. The global parameter list is 
the parameter list used by all subsequent builds. 


Available Parameter List Library screen. 

from: 

Function Global 

key: 

Format: CHANGE GLOBAL PARAMETER LIST or CHAGPL or GLOBAL 


STATUS=status_ variable 


Remarks: @ The currently selected parameter list is 
highlighted on the screen. 


CHANGE_TO_DEFAULT 

Purpose: Changes the parameter under the cursor to its default 
value. 

Available Parameter List screen. 

from: 

Function Reset 

key: 

Format: CHANGE TO DEFAULT or CHATD or RESET 


STATUS=status_variable 


Remarks: e For the processor’s INPUT, OUTPUT, 
INPUT SOURCE MAP, and ERROR parameters the PPE 
default values are chosen. See the Parameter List 
screen for more information. For all other 
parameters, the processor’s default values are 
chosen. 


CLEAR _ SCREEN 


Purpose: Clears and replots the PPE screen, 


Available Any screen. 


from: 

Function Refrsh 

key: 

Format: CLEAR SCREEN or CLES or CLEAR or REFRSH 


STATUS=status_ variable 
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CREATE_DECK 


Purpose : From 


PPE Commands 


the Deck List screen, displays the Deck Creation 


screen; from the Deck Creation screen, executes the 


deck 


Available Deck 
from: 


creation operation. 


Creation or Deck List screen. 


Function Create 
key: 
Format: CREATE DECK or CRED or CREATE 


Remarks e 


Revision A 


STATUS=status_variable 


After the information for a new deck is entered on 
the Deck Creation screen, you use CREATE DECK to 
actually create the new deck. PPE notifies you if 
a deck with the same name already exists in the 
hierarchy; if so, it does not create the deck and 
leaves the Deck Creation screen displayed. 


If the specified modification does not exist at any 
level of the PPE environment catalog hierarchy, PPE 
asks whether you want the modification created with 
SCU default values (SCU does not use the Author 
value from the Tailor Options screen). If you say 
yes to the prompt, PPE creates the modification; 
otherwise, PPE does not create the modification, 
leaves the Deck Creation screen displayed, and does 
not create the deck. 


If the specified modification does not exist at the 
lowest level of the environment catalog hierarchy, 
PPE issues a message and restores the Deck Creation 
screen without creating a new deck. 


If the deck creation succeeds, PPE executes a 


BACK TO PREVIOUS CONTEXT command to return to the 
Deck List screen. 


PPE Quick Reference 4-37 


PPE Commands 


CREATE_MODIFICATION 


Purpose: 


Available 
from: 


Function 
key: 


Format: 


Remarks: 


From the Modification List screen, displays the 
Modification Creation screen; from the Modification 
Creation screen, requests creation of the modification. 


Modification Creation or Modification List screen. 


Create 


CREATE MODIFICATION or CREM or CREATE 
STATUS=status_ variable 


e After the information for a new modification is 
entered on the Modification Creation screen, you 
use CREATE MODIFICATION to actually create the new 
modification. 


e From the Modification List screen, this functon 
takes you to the Modification Creation screen. 


PPE notifies you if a modification with the same 
name already exists in the hierarchy; if so, it 

does not create the modification and leaves the 

Modification Creation screen displayed. 


e If the modification creation succeeds, PPE executes 
a BACK TO PREVIOUS CONTEXT command to return to the 
Modification List screen. 


CREATE_PARAMETER_LIST 


Purpose: 


Available 
from: 


Function 
key: 


Format: 


Remarks: 


Starts a parameter list creation operation by prompting 
for the parameter list name and then displaying the 
Parameter List screen. 


Parameter List Library screen. 
Create 
CREATE PARAMETER LIST or CREPL or CREATE 


STATUS=status variable 


@ The initial values in the new parameter list are 
those of the global parameter list. 


e The new parameter list is saved when you exit the 
Parameter List screen. 
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DELETE_BUILD_FILE 
Purpose: Logically deletes the selected file from the build file 
list. 
& Available Build Files screen. 
from: 
Function Delete 
key: 
Format : DELETE BUILD FILE or DELBF or DELETE 
STATUS=status variable 
Remarks: e You can undo the deletion of a build file using 


Revision A 


UNDO LAST DELETE. This is effective until you 
physically delete the file. 


A logically deleted file becomes physically deleted 
if: 


- Delete protection is ON and you confirm the 
deletion. The delete protection warning is 
displayed when you attempt to leave the current 
screen, execute a command on the home line, or 
execute a command that might reference a 
logically deleted object. 


= You exit PPE. When you exit PPE, all logically 
deleted objects become physically deleted. The 
delete protection warning is not displayed even 
if you selected Delete protection from the 
Tailor Options screen. 


= Delete protection is OFF and you leave the 
current screen, execute a command on the home 
line, or execute a command that might reference 
a logically deleted object. No deletion 
warning is displayed and you cannot veto the 
deletion. 
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DELETE_DECK 

Purpose: Logically deletes the selected decks from the deck list. 

Available Deck List screen. 

from: 6 

Function Delete 

key: 

Format: DELETE DECK or DELD or DELETE 
STATUS=status variable 

Remarks: e The selected decks are the decks that have been 
marked or, if none are marked, the deck under the 
CurSOr. 


® Interlocked decks cannot be deleted. You can clear 
interlocks by using the CHANGE DECK SCU subcommand 
on the home line. However, use caution when 
clearing interlocks; certify that the deck is no 
longer needed in the hierarchy. A deck with 


interlocks cleared cannot be transmitted, nor can 
you transmit to a deck with cleared interlocks. 


e The command deletes the deck copy at the current 
PPE level only. If the deck exists at higher 
levels, the level name listed as the Nearest @ 
Residence of the deck changes. 


@e You can undo the deletion of a deck using 
UNDO LAST DELETE. This is effective until you 
physically delete the decks. 


A logically deleted deck becomes physically deleted 
if: 


= Delete protection is ON and you confirm the 
deletion. The delete protection warning is 
displayed when you attempt to leave the current 
screen, execute a command on the home line, or 
execute a command that might reference a 
logically deleted object. 


= You exit PPE. When you exit PPE, all logically 
deleted objects become physically deleted. The 
delete protection warning is not displayed even 
if you selected Delete protection from the 


Tailor Options screen. @ 


= Delete protection is OFF and you leave the 
current screen, execute a command on the home 
line, or execute a command that might reference 
a logically deleted object. No deletion 
warning is displayed and you cannot veto the 
deletion. @ 
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DELETE_IDENTICAL_ERRORS 


Purpose : 


Available 
from: 


Function 
key: 


Format: 


Remarks: 


Revision A 


Deletes all error messages identical to the highlighted 
error message. Locates the next error message, 
highlights it, and places the cursor as close as 
possible to the location where the error occurred. 


Full Screen Editor session requested from the Build 
Errors screen. 


Del IE 


DELETE IDENTICAL ERRORS or DELIE 
STATUS=status variable 


® PPE decrements the error count for the deck by the 
number of messages deleted. It then finds the next 
error message, highlights it, and positions the 
cursor aS near as possible to the point at which 
the error was detected. 
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DELETE_LIST_ENTRY 

Purpose: Logically deletes the selected file from the library 
list. 

Available Library Lists screen. 

from: 

Function Delete 

key: 

Format: DELETE LIST ENTRY or DELLE or DELETE 


STATUS=status variable 


e You can undo the deletion of a file using 
UNDO LAST DELETE. This is effective until you 
physically delete the files. 


A logically deleted file becomes physically deleted 


if: 


Delete protection is ON and you confirm the 
deletion. The delete protection warning is 
displayed when you attempt to leave the current 
screen, execute a command on the home line, or 
execute a command that might reference a 
logically deleted object. 


You exit PPE. When you exit PPE, all logically 
deleted objects become physically deleted. The 
delete protection warning is not displayed even 
if you selected Delete protection from the 
Tailor Options screen. 


Delete protection is OFF and you leave the 
current screen, execute a command on the home 
line, or execute a command that might reference 
a logically deleted object. No deletion 
warning is displayed and you cannot veto the 
deletion. 


4-42 professional Programming Environment Revision A 


PPE Commands 


DELETE_MODIFICATION 


Purpose: 
Available 
from: 


Function 
key: 


Format: 


Remarks: 


Revision A 


Logically deletes the selected modifications from the 
modification list. 
Modification List screen. 


Delete 


DELETE MODIFICATION or DELM or DELETE 


STATUS=status variable 


The selected modifications are those that are 
marked or, if none are marked, the modification 
under the cursor. 


The command deletes the modification at the cutrent 
PPE level only. If the modification exists at 
higher levels, the level name listed as the Nearest 


Residence of the modification changes. 


You can undo the deletion of a modification using 
UNDO_LAST DELETE. This is effective until you 
physically delete the modification. 


A logically deleted modification becomes physically 
deleted if: 


= Delete protection is ON and you confirm the 
deletion. The delete protection warning is 
displayed when you attempt to leave the current 
screen, execute a command on the home line, or 
execute a command that might reference a 
logically deleted object. 


- You exit PPE. When you exit PPE, all logically 
deleted objects become physically deleted. The 
delete protection warning is not displayed even 
if you selected Delete protection from the 
Tailor Options screen. 


= Delete protection is OFF and you leave the 
current screen, execute a command on the home 
line, or execute a command that might reference 
a logically deleted object. No deletion 
warning is displayed and you cannot veto the 
deletion. 
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DELETE_PARAMETER_LIST 


Purpose: 
Available 
from: 


Function 
key: 


Format: 


Remarks: 


Logically deletes the selected parameter lists from the 
parameter list library. 
Parameter List Library screen. 


Delete 


DELETE PARAMETER LIST or DELPL or DELETE 


STATUS=status_variable 


Select a parameter list by placing the cursor on a 
parameter list name. 


You cannot delete the current global parameter 
list. However, you can change the global parameter 
list using CHANGE GLOBAL PARAMETER LIST and then 
delete the former global parameter list. 


You can undo the deletion of a parameter list using 
UNDO_LAST DELETE. This is effective until you 
physically delete the parameter list. 


A logically deleted parameter list becomes 
physically deleted if: 


- Delete protection is ON and you confirm the 
deletion. The delete protection warning is 
displayed when you attempt to leave the current 
screen, execute a command on the home line, or 
execute a command that might reference a 
logically deleted object. 


- You exit PPE. When you exit PPE, all logically 
deleted objects become physically deleted. The 
delete protection warning is not displayed even 
if you selected Delete protection from the 
Tailor Options screen. 


~ Delete protection is OFF and you leave the 
current screen, execute a command on the home 
line, or execute a command that might reference 
a logically deleted object. No deletion 
warning is displayed and you cannot veto the 
deletion. 
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DELETE_RUN_FILE 


Purpose: Logically deletes the file under the cursor from the 
Run Files list. 
Available Run Files screen. 
from: 
Function Delete 
key: 
Format : DELETE RUN FILE or DELRF or DELETE 
STATUS=status variable 
Remarks: @e You can undo the deletion of a run file using 

UNDO LAST DELETE. This is effective until you 

physically delete the file. 

A logically deleted file becomes physically deleted 

cE? 

- Delete protection is ON and you confirm the 
deletion. The delete protection warning is 
displayed when you attempt to leave the current 
screen, execute a command on the home line, or 
execute a command that might reference a 
logically deleted object. 

= You exit PPE. When you exit PPE, all logically 
deleted objects become physically deleted. The 
delete protection warning is not displayed 
even if you selected Delete protection from the 
Tailor Options screen. 

sa Delete protection is OFF and you leave the 
current screen, execute a command on the home 
line, or execute a command that might reference 
a logically deleted object. No deletion 
warning is displayed and you cannot veto the 
deletion. 

DISPLAY_BANNER 

Purpose: Displays the Banner screen. 

Available Any Screen except the Banner and Screen Stack screens. 
from: 

Function Banner 

key: 

Format: DISPLAY BANNER or DISB or BANNER 


Revision A 


STATUS=status variable 
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DISPLAY_BUILD_ERRORS 


Purpose: Displays the Build Errors screen. 
Available Deck List screen. 

from: 

Function Errors 

key: 

Format: DISPLAY BUILD ERRORS or DISBE or ERRORS 


STATUS=status variable 


DISPLAY_BUILD_FILES 

Purpose: Displays the Build Files screen. 
Available Deck List screen. 

from: 

Function BFiles 

key: 

Format: DISPLAY BUILD FILES or BFILES or DISBF 


STATUS=status variable 


DISPLAY_BUILD_PROCESSORS 


Purpose: Displays the Build Processors screen. 
Available The Build Errors, Build Files, Deck List, Environment 
from: Description, Library Lists, Modification List, Run 


Files, and Tailor Option screens. 


Function BProcs 
key: 
Format: DISPLAY BUILD PROCESSORS or BPROCS or DISBP 


STATUS=status variable 


DISPLAY_LIBRARY_LISTS 


Purpose: Displays the Library Lists screen. 
Available The Build Errors, Build Files, Deck List, Environment 
from: Description, Modification List, Run Files, and Tailor 


Option screens. 


Function LLists 
key: 
Format: DISPLAY LIBRARY LISTS or LLISTS or DISLL 


STATUS=status variable 
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DISPLAY_PARAMETER_LIST_LIBRARY 


Purpose: 


Available 
from: 


Function 
key: 


Format: 


Parameter: 


Displays the Parameter List Library screen. 


The Build Errors, Build Files, Build Processors, Deck 
List, Environment Description, Library Lists, 
Modification List, Parameter List, Run Files, and 
Tailor Options screens. 


PLists 


DISPLAY PARAMETER LIST LIBRARY or PLISTS or DISPLL 
PROCESS OR=name 
STATUS=status variable 


PROCESSOR or P 
Optional name specifying the build processor whose 
parameter list library is to be displayed. The 
build processor names are COBOL, CYBIL, FORTRAN, or 
VECTOR FORTRAN. 


If this parameter is omitted, the currently 
selected build processor is used. The current 
build processor is shown on the Environment 
Description, Tailor Options, and the Build 
Processors screens. 


On the Build Processor screen, the build processor 
selected is the processor under the cursor or the 
highlighted processor if no processor is under the 
cursor. For all other screens, the current build 
processor is selected. 


DISPLAY_REMAINING_ERROR_COUNT 


Purpose: 
Available 
from: 


Function 
key: 


Format: 


Revision B 


Displays the number of error messages remaining in the 
deck being edited. 


Full-Screen Editor session requested from the Build 
Errors screen. 


DisREC 


DISPLAY REMAINING ERROR COUNT or DISREC 
STATUS=status_ variable 
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DISPLAY_RUN_FILES 


Purpose: Displays the Run Files screen. 
Available Deck List or Modification List screens. 
from: 

Function RFiles 

key: 

Format : DISPLAY RUN FILES or RFILES or DISRF 


STATUS=status_ variable 


DISPLAY_SCREEN_STACK 


Purpose: Displays the Screen Stack screen. 

Available Any screen except the Banner and Screen Stack screens. 
from: 

Function Stack 

key: 

Format: DISPLAY SCREEN STACK or DISSS or STACK 


STATUS=status variable 


DISPLAY_SCU_OBJECT_LIST 


Purpose: Displays either the Deck List screen or the 
Modification List screen. 


Available Deck List, Environment Description, or Modification 
from: List screens. 

Function SCUObj 

key: 

Format: DISPLAY SCU OBJECT LIST or DISSOL or SCUOBJ 


OBJECT_KIND=keyword 
STATUS=status variable 
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Parameter: 


Remarks: 


PPE Commands 


OBJECT KIND or OK 


Keyword specifying the kind of SCU object to be 
displayed. Currently, the valid keywords are: 


DECK or DECKS or D 
MODIFICATION or MODIFICATIONS or M 


If this parameter is omitted, the SCU object kind 
(DECKS or MODIFICATIONS) under the cursor is used. 
Otherwise, if the cursor is not positioned on DECKS 
or MODIFICATIONS, PPE prompts for the object kind. 


This operation can also be done by positioning the 
cursor on DECKS or MODIFICATIONS and pressing the 
carriage-return key. 


If the requested screen is already displayed, PPE 
redisplays the screen with updated data. 


If the requested screen is not displayed, but is 
already on the screen stack, PPE executes repeated 
BACK operations until it reaches the requested 
screen. 


@ DISPLAY_TAILOR_OPTIONS 


Purpose: 


Available 
from: 
Function 


key: 


Format: 


Revision B 


Displays the Tailor Options screen. 
The Build Errors, Build Files, Build Processors, Deck 
List, Environment Description, Library Lists, 


Modification List, and Run Files screens. 


Tailor 


DISPLAY TAILOR OPTIONS or DISTO or TAILOR 


STATUS=status variable 
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EDIT_BUILD_FILE 


Purpose: 


Starts a Full-Screen Editor session to display the 
contents of the selected build file. 


Available Build Files screen. 
from: 
Function Edit 
key: 
Format: EDIT BUILD FILE or EDIBF or EDIT 
STATUS=status variable 
Remarks: ® The file to be edited must be a listable file; a 
catalog or an object library cannot be edited. 
EDIT_DECK 
Purpose: Starts a Full-Screen Editor session to edit the 
selected deck. When entered from the Deck Creation 
screen, EDIT DECK also creates the deck. When entered 
from the Build Errors or Deck List screens, it also 
extracts the deck if the deck does not reside at the 
lowest level. 
Available Build Errors, Deck Creation, or Deck List screen. 
from: 
Function Edit 
key: 
Format: EDIT DECK or EDID or EDIT 
STATUS=status variable 
Remarks: e The changes made during the editing session are 


assigned to the current modification. 


e When this command is entered from the Deck Creation 
or Deck List screen, PPE displays only the deck 
source text for editing. However, when this 
command is entered from the Build Errors screen, 
the error diagnostics from the last build are 
inserted in the text where they occurred. 
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EDIT_DECK_TEMPLATE 


Purpose: 


Available 
from: 


Function 
key: 


Format: 


Parameter: 


Revision B 


Starts a Full-Screen Editor session to edit the 
selected deck template. 


Build Processors screen. 


EdiDT 


EDIT DECK TEMPLATE or EDIDT 
PROCESSOR=name 
STATUS=status variable 


PROCESSOR or P 
Optional name of the build processor whose deck 
template is to be edited. The build processor 
names are COBOL, CYBIL, FORTRAN, or VECTOR FORTRAN. 


If this parameter is omitted, the processor under 
the cursor is used. If the cursor is not 
positioned on the name of a build processor, the 
currently selected build processor is used. (This 
selected build processor is highlighted on the 
screen.) 
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EDIT_PARAMETER_LIST 


Purpose: 


Available 
from: 


Function 
key: 


Format: 


Parameter: 


Revision B 


Enables editing of the selected parameter list. 


Any screen except the Banner, Deck Creation, 
Modification Creation, and Screen Stack screens. 


EdiPL 


EDIT PARAMETER LIST or EDIPL 
PARAMETER LIST=name 
PROCESSOR=name 
STATUS=status variable 


PARAMETER LIST or PL 
Optional name of the parameter list to be edited. 
To see the names of the existing parameter lists, 
display the Parameter List Library screen for the 
selected build processor using 
DISPLAY PARAMETER LIST LIBRARY. 


If the specified parameter list does not exist, PPE 
displays a message which you must acknowledge to 
continue the PPE session. 


If this parameter is omitted, the parameter list 
displayed depends upon the screen currently 
displayed, as follows: 


Parameter List - PPE prompts you for a parameter 
screen list name. 

Parameter List ~ PPE displays the parameter list 
Library screen under the cursor. If no 


parameter list is under the 
cursor, PPE displays the global 
parameter list of the current 
build processor. 


All other - PPE displays the global 


screens parameter list of the current 
build processor. 
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PROCESSOR or P 


Remarks: e 


EDIT_RUN_FILE 


Optional name of the build processor for which 
the parameter list is specified. To see the 
names of the build processors available, 
display the Build Processors screen using 
DISPLAY BUILD PROCESSORS. 


If this parameter is omitted, the build 
processor selected depends upon the screen 
currently displayed, as follows: 


Build Processors —- PPE selects the processor 

screen under the cursor. If the 
cursor in not on a 
processor, the highlighted 
processor is chosen. 


Parameter List —- PPE selects the processor 

Library screen named at the top of the 
screen. 

Parameter List - PPE selects the processor 

screen named at the top of the 
screen. 

All other - PPE selects the current 

screens build processor. 


When EDIT PARAMETER LIST is used on the 
Parameter List screen and specifies another 
parameter list, the currently displayed 
parameter list is saved before the next list is 
displayed. 


Purpose: Starts a Full-Screen Editor session to display the 
contents of the selected run file. 


Available Run Files screen. 

from: 

Function Edit 

key: 

Format: EDIT RUN FILE or EDIRF or EDIT 


STATUS=status variable 


Remarks: @ The file to be edited must be listable; a catalog 
or an object library cannot be edited. 
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END_MARK 


Purpose: Marks the last object in a range of selected objects. 


Available The Build Errors, Deck List, and Modification List 


from: screens. 

Function EndMrk 

key: 

Format: END MARK or ENDMRK or ENDM 


- STATUS=status_ variable 


Remarks: @ A corresponding BEGIN MARK command must precede 
each END MARK command. 


EXPLAIN_ERROR_MESSAGE 


Purpose: Displays the online manual explanation of an error 
message. The error message is either the one under the 
cursor or, if the cursor is not positioned on a 
message, the highlighted message. 


Available Full-Screen Editor session requested from the Build 
from: Errors screen. 
© Function Assist 
key: 
Format : EXPLAIN ERROR MESSAGE or EXPEM or ASSIST 


STATUS=status variable 


EXPORT_BUILD_FILE 


Purpose: Copies the selected file from the Build File list to 
another file. PPE prompts you for the file to which it 
copies the build file. 


Available Build Files screen. 

from: 

Function Export 

key: 

Format : EXPORT BUILD FILE or EXPBF or EXPORT 


STATUS=status variable 
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EXPORT_RUN_FILE 


Purpose: 


Copies the selected Run File to another file. PPE 


prompts you for the file to which it copies the run 
file. 


Available Run Files screen. 
from: 
Function Export 
key: 
Format : EXPORT RUN FILE or EXPRF or EXPORT 
STATUS=status variable 
EXTRACT_SOURCE 
Purpose: Copies the selected decks from their nearest residence 
in the higher levels of the PPE hierarchy to your PPE 
level and sets an interlock on each deck. 
Available Build Errors or Deck List screen. 
from: 
Function ExtS 
key: 
Format : EXTRACT SOURCE or EXTS 
STATUS=status variable 
Remarks: @ A deck cannot be extracted if it is already 


interlocked or if it already exists at the lowest 
level of the environment catalog hierarchy. A deck 
is already extracted if its Nearest Residence is 
the current PPE level. 
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FORMAT_SOURCE_TEXT 


Purpose: 


Available 
from: 


Function 
key: 


Format: 


Remarks: 


Revision A 


Executes the source text formatter for the build 
processor to format the text in the deck being edited. 


Full-Screen Editor session. 
For ST 


FORMAT SOURCE TEXT or FORST 
STATUS=status variable 


e FORMAT SOURCE TEXT looks for a command with a name 
of the form FORMAT processor name SOURCE where 
processor name is the name of the processor for the 
source file being edited (for example, 

FORMAT COBOL SOURCE). If FORMAT SOURCE TEXT finds 
a command with a name of this form, it executes the 
command. Two parameters are passed to the 

command: the name of the source file to be 
formatted, and the name of the file to contain the 
formatted source. 


If a command of the form 

FORMAT processor name SOURCE is not found and PPE 
provides a source code formatter for the processor, 
then the PPE provided formatter is used to format 
the source code. Currently, PPE only provides a 
source code formatter for FORTRAN Version l. 


If a command of the form 

FORMAT processor name SOURCE is not found and PPE 
does not provide a source code formatter for the 
processor, PPE issues a message informing you that 


a formatter does not exist for the processor. 


e Currently, the only source text formatter supplied 
by PPE is for FORTRAN Version 1. 


The text to be formatted must be in the correct 


zones within each line (labels must be in columns 
1 through 5, statements at column 7 and on). The 
formatter standardizes the format, indenting block 
structure and standardizes labels. 
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HOME_CURSOR 

Purpose: Positions the cursor at the beginning of the home line. 
Available Any screen except the Banner screen. 

from: 

Function Home 

key: 

Format : HOME CURSOR or HOMC or HOME 


STATUS=status variable 


IMPORT_BUILD_FILE 


Purpose: Copies a file to a file in the PPE Build File 
subcatalog. You specify the file to be copied in 


response to a prompt. PPE also prompts you for the 


name to be given the new PPE file. 


Available Build Files screen. 

from: 

Function Import 

key: 

Format : IMPORT BUILD FILE or IMPBF or IMPORT 


STATUS=status variable 


IMPORT_RUN_FILE 


Purpose: Copies a file to a file in the PPE Run File 
subcatalog. You specify the file to be copied in 


response to a prompt. PPE also promptes you for the 


name to be given the new PPE file. 


Available Run Files screen. 

from: 

Function Import 

key: 

Format : IMPORT RUN FILE or IMPRF or IMPORT 


STATUS=status variable 
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IMPORT_SOURCE_LIBRARY 


Purpose: 


Available 
from: 


Function 
key: 


Format: 


Parameter: 


Remarks: 


Combines the specified SCU source library outside of 


PPE with the PPE source library at this level. 
Interlocks are not checked. 


Environment Description screen. 
Import 


IMPORT SOURCE LIBRARY or IMPORT or IMPSL 
SOURCE LIBRARY=file 
STATUS=status variable 


SOURCE LIBRARY or SL 
File path for the source library file to be 


imported. If you omit this parameter, PPE prompts 
you for the file path. 


@ Before you import a library, you should set the 
processor field in the header of each deck in the 
library to the name of the build processor for that 
deck. Use the SCU CHANGE DECK command to change 
the deck headers. 7 


INSERT_LIST_ENTRY 


Purpose: 


Available 
from: 


Function 
key: 


Format: 


Remarks: 
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Inserts a list entry before the list entry under the 
cursor. The subsequent list entries are moved down one 
entry. You can add a new name to the list by typing it 
at the prompt. 


Library Lists screen. 


Insert 


INSERT LIST ENTRY or INSLE or INSERT 
STATUS=status variable 


e To insert an entry at the end of the list, place 


the cursor on the line following the last entry in 
the list prior to executing the command. Use 
PAGE FORWARD (FWD) to reach the end of the list. 
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LOCATE_DECK 


Purpose: 


Available 
from: 


Function 
key: 


Format: 


Parameter: 


Remarks: 


Searches the deck list for the first name containing 
the specified string of characters and positions the 
cursor on that name. 


Deck List screen. 
Locate 


LOCATE DECK or LOCD or LOCATE 
MATCH STRING=string 
STATUS=status variable 


MATCH STRING or MS 
Optional string of characters for which PPE is to 
search. The string must be enclosed in apostrophe 
(“) characters. If the parameter is omitted, PPE 
prompts for the string. When you enter the string, 
do not enclose it in apostrophes. If you supply no 
String in response to the prompt, PPE uses the 
string from the last LOCATE DECK command. 


ce) LOCATE DECK positions the cursor on the deck it 


finds which contains characters matching the 
string. It does not move the cursor if it finds no 
deck name containing the MATCH STRING value. 


e The search starts from the current cursor position 


in the deck list. 
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LOCATE_MODIFICATION 


Purpose: Searches the modification list for the first name 
containing the specified string of characters and 
positions the cursor on the name. 


Available Modification List screen. 

from: 

Function Locate 

key: 

Format: LOCATE MODIFICATION or LOCM or LOCATE 


MATCH STRING=string 
STATUS=status variable 


Parameter: MATCH STRING or MS 
Optional string of characters for which PPE is to 
search. The string must be enclosed in apostrophe 
(~) characters. 


If the parameter is omitted, PPE prompts for the 
String. When you enter the string, do not enclose 
it in apostrophes. If you supply no string in 
response to the prompt, PPE uses the string from 
the last LOCATE MODIFICATION command. 


©® Remarks: ® LOCATE MODIFICATION positions the cursor on the 
modification it finds which contains characters 
matching the MATCH STRING value. 
LOCATE MODIFICATION does not move the cursor if it 
finds no modification name containing the 


MATCH STRING value. 


® The search starts from the current cursor position 
in the deck list. 
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LOCATE_NEXT_ERROR 


Purpose: Moves the cursor to the next error, highlighting the 
corresponding error message. Deletes the currently 
highlighted error message. 


Available Full-Screen Editor session requested from the Build 
from: Errors screen. 

Function NxtErr 

key: 

Format: LOCATE NEXT ERROR or LOCNE or NXTERR 


STATUS=status variable 


Remarks: e PPE decrements the error count for the deck. It 
then finds the next error message, highlights it, 
and positions the cursor as near as possible to the 
point at which the error was detected. 


LOOKUP_KEYWORD 


Purpose: Searches for the word under the cursor in the index of 
the online manual for the language and, if found, 
displays the associated online manual screen. 


Available Full-Screen Editor session. 
from: 


Function key: LookUp 


key: 
Format: LOOKUP KEYWORD or LOOK or LOOKUP 
STATUS=status variable 
Remarks: © To return to PPE from the online manual, use the 


Quit function key or type QUIT and press the 
carriage-return key. 


e The online manuals used for the build processors 


COBOL, CYBIL, FORTRAN, and VECTOR FORTRAN are 
COBOL, CYBIL, FORTRAN, and VFORTRAN respectively. 
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LOWER_DISPLAY_CEILING 
Purpose: Lowers the display ceiling the specified number of 
levels. 
@ Available Deck List or Modification List screens. 

from: 

Function Lower 

key: 

Format : LOWER DISPLAY CEILING or LOWDC or LOWER 
NUMBER OF LEVELS=integer or key 
STATUS=status variable 

Parameter: NUMBER OF LEVELS or NL 


Number of levels the display ceiling is to be 
lowered. The value must be an integer greater than 
0 or the keyword BOTTOM, which lowers the display 
ceiling to the lowest level in the hierarchy. 


If the number specified is greater than the number 
of levels that the ceiling can be lowered, BOTTOM 
is used instead. 


The default value of this parameter is l. 


MOVE_TO_BOTTOM 


Purpose : 


Available 
from: 


Function 
key: 


Format: 


Revision A 


Repositions the list so that the object under the 
cursor is the last object displayed on the page. 


Build Errors, Build Files, Deck List, Environment 
Description, Library List, Modification List, Parameter 
List, Parameter List Library, Run Files, and Screen 
Stack screens. 

Down 


MOVE TO BOTTOM or MOVTB or DOWN 
STATUS=status variable 


PPE Quick Reference 4-61 


PPE Commands 


MOVE_TO_FIRST 
Purpose: Repositions the list so the beginning of the list is 
displayed and the cursor is positioned on the first 
object in the list. 
Available Build Errors, Build Files, Deck List, Environment 
from: Description, Library List, Modification List, Parameter 
List, Parameter List Library, Run Files, and Screen 
Stack screens. 
Function First 
key: 
Format: MOVE TO FIRST or MOVTF or FIRST 
STATUS= Status variable 
MOVE_TO_LAST 
Purpose: Repositions the list so the end of the list is 
displayed and the cursor is positioned on the last 
object in the list. 
Available Build Errors, Build Files, Deck List, Environment 
from: Description, Library List, Modification List, Parameter 
List, Parameter List Library, Run Files, and Screen 
Stack screens. 
Function Last 
key: 
Format: MOVE TO LAST or MOVTL or LAST 
. STATUS=status variable 
MOVE_TO_TOP 
Purpose: Repositions the list so that the object under the 
cursor is the first object displayed. 
Available Build Errors, Build Files, Deck List, Environment 
from: Description, Library List, Modification List, Parameter 
List, Parameter List Library, Run Files, and Screen 
Stack screens. 
Function Up 
key: 
Format: MOVE TO TOP or MOVTIT or UP 


STATUS=status _ variable 
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PAGE_ BACKWARD 

Purpose: Repositions the list so that the first object displayed 
becomes the last object displayed. 

Available Build Errors, Build Files, Deck List, Environment 

from: Description, Library List, Modification List, Parameter 
List, Parameter List Library, Run Files, and Screen 
Stack screens. 

Function Bkw 

key: 

Format : PAGE BACKWARD or PAGB or BKW 

STATUS=status variable 

PAGE FORWARD 

Purpose: Repositions the list so that the last object displayed 
becomes the first object displayed. 

Available Build Errors, Build Files, Deck List, Environment 

from: Description, Library List, Modification List, Parameter 
List, Parameter List Library, Run Files, and Screen 
Stack screens. 

Function Fwd 

key: 

Format : PAGE FORWARD or PAGF or FWD 

STATUS=status variable 
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PRINT_BUILD_FILE 


Purpose: Prints the selected build file using the site-provided 
PRINT command if available; otherwise, it uses the 
standard NOS/VE PRINT FILE command. 


Available Build Files screen. 

from: 

Function Print 

key: 

Format: PRINT BUILD FILE or PRIBF or PRINT 


STATUS=status variable 


Remarks: @ The file to be printed must be a list file; it 
cannot be the object library. 


e PPE passes only one parameter to the print 
command: the file path. 


@ When PPE executes the PRINT BUILD FILE command, it 
first executes an SCL command with the following 
form: 


PRINT 1lfn 
where 1lfn is the file path of the file to be @ 
printed. If no PRINT command exits, PPE executes 


the standard NOS/VE PRINT FILE command with default 
settings. 
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PRINT_RUN_FILE 


Purpose : Prints the selected run file using the site-provided 
PRINT command if available; otherwise, it uses the 
standard PRINT FILE command. 

Available Run Files screen. 

from: 

Function Print 

key: 

Format : PRINT RUN FILE or PRIRF or PRINT 

STATUS=status variable 
Remarks: @ The file to be printed must be a list file; it 

cannot be the object library. 

e PPE passes only one parameter to the print 
command: the file path. 

® When PPE executes the PRINT RUN FILE command, it 
first executes an SCL command with the following 
form: 

PRINT 1fn 

where lfn is the file path of the file to be 
printed. If no PRINT command exits, PPE executes 
the standard NOS/VE PRINT FILE command with default 
settings. 

QUIT_SAVE 

Purpose: Ends the PPE session, saving all information required 
for your next session to begin where this one ended. 

Available Any screen. 

from: 

Function Quit 

key: 

Format : QUIT SAVE or QUIS or QUIT or QUI 

STATUS=status variable 

Remarks: When you exit PPE, a new high cycle of the source 
library within your environment catalog is created. 
The low cycles allow you to recover freom catastrophic 
events. However, you can easily use up a large amount 
of file space. To avoid using excess file space, you 
should frequently delete the low cycles of your source 
library. You can use EDIT CATALOG from the home line 
of your environment catalog to do this. 
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RAISE_DISPLAY_CEILING 


Purpose: Raises the display ceiling the specified number of 
levels. 

Available. Deck List or Modification List screen. 

from: 

Function Raise 

key: 

Format : RAISE DISPLAY CEILING or RAIDC or RAISE 
NUMBER OF LEVELS=integer or key 
STATUS=status_ variable 

Parameter: NUMBER OF LEVELS or NL 
Number of levels the display ceiling is to be 
raised. The value can be an integer greater than 0 
or the keyword TOP, which raises the display 
ceiling to the highest level in the hierarchy. 
If the number specified is greater than the number 
of levels that the ceiling can be raised, TOP is 
used instead. 
The default value of this parameter is l. 

REMOVE_MARK 

Purpose: Removes the selected marks from the list. 

Available Build Errors, Deck List, and Modification List screens. 

from: 

Function UnMark 

key: 

Format: REMOVE MARK or REMM or UNMARK 
MARK SCOPE=key 
STATUS=status_ variable 

Parameter: MARK SCOPE or MS 


Keyword specifying the marks that are removed. 


ALL or A All marks in the list. 

INDIVIDUAL or I Individual mark under the cursor 
(default). 

RANGE or R Marked range under the cursor. 


If you omit the MARK SCOPE parameter, the default 
value is INDIVIDUAL. 
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REQUEST_HELP 


Purpose: 


Available 
from: 


Function 
key: 


Format: 


Remarks: 
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Displays help information. When help is requested on 
the Banner Screen, PPE displays the PPE online manual. 
Otherwise, this command displays help information about 
the object or keyword under the cursor or the current 
message on the message line. 


Any screen. 


Help 


REQUEST HELP or REQH or HELP 


STATUS=status variable 


If a help message is available for the object, 
REQUEST HELP displays a window containing brief 
help information. The window also tells you how to 
display further information in the PPE online 
manual and how to return to PPE. 


If no window help is available for the object, the 
PPE online manual index is searched for the 
object. If the object is found in the index, the 
corresponding online manual screen is displayed. 


To leave the online manual, use the Quit function 
key or type QUIT and press the carriage-return 
key. You are returned to PPE. 


After receiving help, PPE always returns you to the 
screen where you requested help. 
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RUN 


Purpose: 


Available 
from: 


Function 
key: 


Format: 


Parameter: 


Remarks: 


Loads and executes the product. 


Run Files screen. 


Run 


RUN 


RUN_PURPOSE=keyword 
STATUS=status_variable 


RUN_PURPOSE or RP 
Keyword indicating how the product should be 
executed: 


NORMAL or N 


INTERACTIVE _ 
DEBUG or ID 


Execute without control by the 


Full-Screen Debug utility. 


Execute under control of the 
Full-Screen Debug utility. The 


product must have been built using 
the debug options in its parameter 
list. The debug options are: 


OPTIMIZATION_LEVEL=DEBUG 


DEBUG_AIDS=DT 


INPUT_SOURCE_MAP=S INPUT_SOUR 


CE_MAP 


If you omit the RUN_PURPOSE parameter, the Run 
Purpose selected on the Run Files screen is used. 


@ PPE loads the object library existing at this 


It then satisfies the external references 
When searching for the entry point to 


it searches in the following order: 


In the PPE object library at the current level. 


In the PPE object library at each higher level 


level. 

in the library by loading modules from other object 

libraries. 

satisfy an external reference or starting 

procedure, 

1. 

2 
upwards in the hierarchy. 

3. In the object libraries specified in the 
program library list on the Library lists 
screen in the order listed. 

4. 


In the object libraries listed in the job 


library list in the order the library files are 


listed. 
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Program execution begins with the starting 
procedure as specified on the Tailor Options 
screen. (The default starting procedure is the 
last transfer symbol loaded, the same default in 
effect outside of PPE.) 


The program reads its input files and writes its 
output files. It may also write the following run 
files: 


SLOADMAP 
A load map is written to this run file if 
the LOAD MAP OPTIONS program attribute has 
been changed from its default value, NONE. 
To change the program attribute, you must 
enter the SCL command 
SET PROGRAM ATTRIBUTES. 


STERMINAL OUTPUT 
All output data sent to SOUTPUT is written 
to this run file. 


When you execute the Run function, PPE searches 
every object library in your hierarchy. The loader 
produces a warning level error message if it 
encounters an empty object library. Since PPE sets 
the initial termination error level for a job to 
WARNING, an empty library might cause your run to 
terminate prematurely. 


You can change the termination error level with the 
SCL SET PROGRAM ATTRIBUTES command. The 
recommended settings are WARNING and ERROR. The 
following lists the merits of each choice: 


ERROR An empty object library does not 
terminate a run. However, PPE does not 
inform you when any warning level error 
messages are produced, and the run 
might terminate unexpectedly. Also, 
you are not informed if an empty object 
library is encountered, even if none 
should be empty. 


WARNING Any WARNING level error message 
terminates a run. Therefore, an empty 
object library causes a run to 
terminate. 


Regardless of the termination error level setting 


for your job, all errors are written to the 
SLOADMAP file. 
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SKIP_LINE_ERRORS 


Purpose: Deletes all error messages associated with the same 
source line as the highlighted message. Highlights 
the first remaining error message, moving the cursor as “ 
close as possible to the location where it occurred. © 


Available Full-Screen Editor session requested from the Build 
From: Errors screen. 

Function Skip 

key: 

Format : SKIP LINE ERRORS or SKILE or SKIP 


STATUS=status_ variable 


TRANSMIT_SOURCE 


Purpose: Copies the selected decks to the source library at the 
next higher PPE level, clears the deck interlocks, and 
deletes the decks from the lower PPE level. 


Available Deck List screen. 

from: 

Function Tras 

key: 

Format: TRANSMIT SOURCE or TRAS 
STATUS=status variable 

Remarks: @ PPE attempts to transmit all decks marked or, if 
none are marked, it transmits the deck under the 
cursor. 


® TRANSMIT SOURCE always transmits decks from the 
lowest level in the environment catalog hierarchy 
to the source library at the next higher level. 


e Only decks residing in the lowest level of the 
environment catalog hierarchy can be transmitted. 
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When you transmit source, a new high cycle of the 
source library within your environment catalog is 
created. The low cycles allow you to recover from 
catastrophic events. However, you can easily use 
up a large amount of file space. To avoid using 
excess file space, you should frequently delete the 
low cycles of you source library. You can use 

EDIT CATALOG from the home line of your environment 
catalog to do this. 


When you transmit source, the object modules in the 


lowest level of your environment catalog hierarchy 
that are built by that source should be deleted 


from the highest cycle of SOBJECT LIBRARY on the 
Build Files screen. The CREATE OBJECT LIBRARY 
utility can be used from the home line of the Build 
Files screen to do this. 


Also, after you transmit, notify the owner of the 
next higher level in your hierarchy to do a build 
using the transmitted decks. This keeps the 
SOBJECT LIBRARY at the higher level of the 
hierarchy up to date, incorporating your 
transmitted source code into the object code at 
that level. 


Changes made to the source library are not 
available to other tasks or PPE sessions at lower 
levels in the hierarchy until you exit the PPE 
session in which the changes occurred, or until the 
changed decks are transmitted to the next higher 
level in the hierarchy. 
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UNDO_LAST_DELETE 


Purpose: 


Available 
from: 


Function 
key: 


Format : 


Remarks: 
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Removes the effect of the last logical deletion 
Operation, restoring the deleted objects. However, 
physically deleted objects cannot be restored. 


Build Files, Deck List, Library Lists, Modification 
List, Parameter List Library, or Run Files screen. 


Undo 


UNDO LAST DELETE or UNDLD or UNDO 


STATUS=status variable 


A logically deleted object becomes physically deleted 


if: 


Delete protection is ON and you confirm the 
deletion. The delete protection warning is 
displayed when you attempt to leave the current 
screen, execute a command on the home line, or 
execute a command that might reference a logically 
deleted object. 


You exit PPE. When you exit PPE, all logically 
deleted objects become physically deleted. The 
delete protection warning is not displayed even if 
you selected Delete protection from the Tailor 
Options screen. 


Delete protection is OFF and you leave the current 
screen, execute a command on the home line, or 
execute a command that might reference a logically 
deleted object. No deletion warning is displayed 
and you cannot veto the deletion. 


A physically deleted object cannot be recovered by 
using UNDO LAST DELETE. 
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This appendix lists terms with their definitions as used in this 
manual. 


A 


Author 


Identification of the original creator of a deck or modification 
as stored in its header. 


B 


Build 


Process by which PPE constructs the executable object library 
from decks on a source library. To do so, it calls SCU to 
expand the decks, then calls the build processor to compile the 
expanded text, and finally calls the object library generator to 
combine the object modules with the existing object library. 


Build Processor 
The software that PPE calls to transform the expanded deck text 


into object modules. The supported build processors are the 
NOS/VE COBOL and FORTRAN Version 1 compilers. 


Cc 


Catalog 


A system-maintained directory whose entries describe NOS/VE 
files and subcatalogs. The NOS/VE file system is organized as a 
hierarchy of catalogs. Each user has a master catalog, which is 
the top of the user”s catalog hierarchy. 

Compilation 


The process of transforming source text into object code. 
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Context 


Within PPE, the screen currently displayed, including the cursor 
position and any currently displayed messages. It determines 
the commands currently available and the context in which they 
are executed. 


Creation Modification 
The modification specified when a deck is created. The initial 
source text in the deck belongs to the creation modification. A 
creation modification cannot be deleted until all decks for 
which the modification is a creation modification are deleted. 


Cursor 


The pointer displayed by your terminal that you can position to 
specify a screen location. 


D 


Deck 


An SCU object consisting of a sequence of lines with a 
descriptive header. Under PPE, the lines in a deck are a unit of 
source text that can be expanded by SCU and then compiled by the 
build processor. 


Default 


The assumed value for a parameter when the parameter is not 
specified by the user. 


Diagnostic Message 
Text issued to describe an error that has been detected. PPE 
weaves the diagnostic messages issued for a build by the build 
processor into the source text so that the message is as near as 
possible to the point at which the error was detected. 


Display Ceiling 


Highest level in the PPE hierarchy whose contents are included 
in displayed lists. 
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Entry Point 


A location in a module at which execution of the module can 
begin. During the loading process, an entry point is found to 

match each external reference in the product. 

Environment 
The data and operations available to the programmer. 

Execution 
The carrying out of a program’s instructions by the computer. 

Expand Attribute 
A deck header field that determines whether the deck can be 
expanded directly or whether it can be expanded only when it is 
copied by another deck. 

Expansion 
The process by which SCU reformats the compressed text stored in 
a deck so that it can be used as input text to a build 
processor. As it expands the deck, it processes all SCU 
directives embedded in the deck text. 

External Reference 
A call to an entry point in another module. The loading process 
satisfies external references by matching each external 
reference to its entry point. 

Extraction 
The process by which an existing deck at a higher level is made 
available for editing under PPE. PPE copies the deck from the 
nearest higher level of the PPE hierarchy, sets an interlock on 


the original deck and its copy, and combines the deck copy with 
the source library at the bottom of the hierarchy. 
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File Path 


The means of identifying a NOS/VE file. It specifies the 
location of the file entry by the sequence of catalog names that 
lead to the file entry in the hierarchy of catalogs. The last 
name in the file path is the name of the file itself. For more 
information, see the SCL Language Definition manual. 


FSE 


Full-Screen Editor; the NOS/VE editor that allows you to edit 
text either in line mode or screen mode. 


Full-Screen Application 


A program whose user interface sends and receives screens of 
information, not just individual lines. Such a program can be 
used only from a terminal having both the minimal capabilities 
required by the program and a terminal definition defining those 
capabilities. 


Function Key 


A key on the terminal keyboard that, when pressed, transmits a 
unique, identifying character sequence. The terminal definition 
for a full-screen terminal defines the function keys available. 
As a full-screen application, PPE uses the terminal definition 
so that when you press a function key PPE executes the command 
associated with that key. 


G 


Global Parameter List 


The currently selected parameter list for the build processor. 


H 


Hierarchy 


A specified rank or order of items. PPE supports a hierarchy of 
levels; a user can change data only at the lowest level in the 
hierarchy, but has access to data at higher levels. 


Home Line 
The line on the terminal screen to which the cursor returns when 
the HOME CURSOR operation is performed or when the terminals 


hardwired HOME key is pressed. The user can enter commands only 
on the home line. 
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A field set in a deck header indicating that the deck has been 
extracted. The original interlock field is set on header of the 
the original deck in the source library from which the deck was 
extracted; the subinterlock field is set in the header of the 
deck copy. 


L 


Level 
Rank within a hierarchy. A PPE level is a catalog containing 


required PPE files and catalogs, including a source library, an 
object library, and other data files. 


M 


Modification 


An SCU object consisting of a set of inserted, replaced, and 
deleted lines with a descriptive header. 


N 


Name 


SCL identifier consisting of a sequence of 1] through 31 
characters. The characters can be letters, digits, and the 
following special characters: 


CS Ne Oe We 


The first character cannot be a digit. 


O 


Object Library 
A file containing one or more executable modules and a directory 
to each module and its entry points. PPE maintains an object 
library at each level of the hierarchy. 

Object Module 
A compiler-generated unit containing object code and 


instructions for loading the object code. Under PPE, all object 
modules are stored in object libraries. 
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Parameter List 


A string of specifications passed to a program when its 
execution is begun. PPE passes a parameter list to the build 
processor for each build. It also passes a parameter list to 
the product for each run. 


Parameter List Library 


A collection of parameter lists stored for a build processor. 
The PPE user can create, edit, and select parameter lists in the 
library. 


Program Library List 


A list of object libraries searched by the loader for entry 
points when the entry points do not exist in the PPE object 
libraries. After searching the program library list provided by 
PPE, the loader then searches the job library list, the job 
Debug library list (if the run purpose is INTERACTIVE DEBUG), 


and, finally, the NOS/VE task services library. 


Run 


An instance of execution of the software product being developed 
using PPE. 


S 


Screen 


A formatted collection of information that can be displayed at 
one time on a terminal screen. The currently displayed PPE 
screen determines the context in which PPE operates and the 
commands available to the user. 


SCU 
Source Code Utility; the NOS/VE command utility that PPE uses to 
manage decks and modifications on source libraries. 

SCU Object 


Entity generated and maintained by SCU. Currently, the only SCU 
objects that PPE supports are decks and modifications. 
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Source Library 


A collection of decks on a file with a descriptive header, 
generated and maintained by SCU. PPE maintains a source library 
at each level of a PPE hierarchy. 


Source Text 


The sequence of lines provided as input to a compiler or other 
processor. 


Stack 


Data structure in which data items are retrieved in reverse 
order from that in which the items were stored. An item stored 
in the stack is said to be pushed on the stack; an item 
retrieved from the stack is said to be popped off the stack. 
PPE maintains a stack showing the path the user has taken down 
the PPE screen hierarchy; each BACK command pops a screen from 
the stack. 


T 


Terminal Definition 


A module that defines the capabilities of an interactive 
terminal. An interactive session must define the terminal it is 
using before executing any full-screen application. 


Text-Embedded Directive 


An SCU directive inserted at the point in the deck text at which 
the directive is to be processed when the deck is expanded. The 
most commonly used directives are the copy directives that 
expand the text of another deck and insert it into the deck 
containing the copy directive. 


Transfer symbol 


An entry point within a module at which program execution can 
begin. 


Transmittal 
The process by which decks in the lowest level of the 
environment catalog hierarchy are moved to the source library at 
the next higher level of the PPE hierarchy. Deck interlocks are 


enforced and the decks are deleted from the lower level of the 
hierarchy. 
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e~ 


Related Manuals 


This appendix lists the manuals related to this manual and describes 
how you can acquire them. 


A complete list of NOS/VE manuals is provided as appendix B in the 
SCL Language Definition manual. 


The following list includes all manuals that are either referenced 
in this manual or contain additional information that may be of use 
to the reader of this manual. It lists the publication number of 
printed manuals and the manual name for online manuals. (The manual 
name is the name specified on the MANUAL parameter of the EXPLAIN 
command; for example, EXPLAIN,M=DEBUG. ) 


Publication Online Manual 
Manual Title Number Name 
SCL Manuals: 
Debug for NOS/VE 60488213 
Usage 
Debug for NOS/VE DEBUG 
Quick Reference 
Diagnostic Messages for NOS/VE 60464613 MESSAGES 
Quick Reference 
Full Screen Editor for NOS/VE 60464015 
Tutorial/Usage 
NOS/VE System 60464014 
Usage 
NOS/VE Object Code Management 60464413 
Usage 
NOS/VE Source Code Management 60464313 
Usage 
Terminal Definition 60464016 
Usage 

(Continued) 
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Related Manuals 


(Continued) 


Publication Online Manual 
Manual Title Number Name 


Language Manuals: 


COBOL for NOS/VE 60486013 COBOL 
Usage 


FORTRAN for NOS/VE 60485913 
Language Definition 
Usage 


FORTRAN for NOS/VE 60485916 
Topics for FORTRAN Programmers 
Usage 


FORTRAN for NOS/VE FORTRAN 
Quick Reference 


Math Library 60486513 
Usage 


Accessing Online Manuals 


If your site has installed the NOS/VE online manual set, you can 
find an abstract for each NOS/VE manual in the NOS_VE online 
manual. To access the NOS VE online manual, enter the SCL command: 


explain, manual=nos ve 


Ordering Printed Manuals 


You can order printed Control Data manuals from your local Control 
Data sales office. Sites in the U.S. can also order manuals 
directly from the following address: 


Control Data Corporation 

Literature and Distribution Services 
308 North Dale Street 

St. Paul, Minnesota 55103 


When ordering manuals, please indicate whether you require the 
entire manual or just the latest revision packet. 
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ASCII Character Set C 


This appendix lists the ASCII character set (table C-1). 


NOS/VE supports the American National Standards Institute (ANSI) 
standard ASCII character set (ANSI X3.4-1977). NOS/VE represents 
each 7—bit ASCII code in an 8-bit byte. The 7 bits are 
right-justified in each byte. For ASCII characters, the leftmost 
bit is always zero. 


In addition to the 128 ASCII characters, NOS/VE allows use of the 


leftmost bit in an 8—bit byte for 256 characters. The use and 
interpretaion of the additional 128 characters is user-defined. 
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ASCII Character Set 


Table C-1. ASCII Character Set (Continued) 
ASCII Code Graphic or 

Decimal (Hexadecimal ) Octal Mnemonic - Name or Meaning 

000 00 000 NULL Null 

001 01 001 SOH Start of heading 

002 02 002 STX Start of text 

003 03 003 ETX End of text 

004 04 004 EOT End of transmission 

005 05 005 ENQ Enquiry 

006 06 006 ACK Acknowledge 

007 07 007 BEL Bell 

008 08 010 BS Backspace 

009 09 Oll HT Horizontal tabulation 

010 0A 012 LF Line feed 

011 OB 013 VT Vertical tabulation 

012 OC 014 FF Form feed 

013 OD 015 CR Carriage return 

014 OE 016 SO Shift out 

O15 OF 017 SI Shift in 

016 10 020 DLE Data link escape @ 

017 11 021 DCL Device control 1 

018 12 022 DC2 Device control 2 

019 13 023 DC3 Device control 3 

020 14 024 DC4 Device control 4 

021 15 025 NAK Negative acknowledge 

022 16 026 SYN Synchronous idle 

023 17 027 ETB End of transmission 
block 

024 18 030 CAN Cancel 

025 19 031 EM End of medium 

026 1A 032 SUB Substitute 

027 1B 033 ESC Escape 

028 1C 034 FS File separator 

029 1D 035 GS Group separator 

030 1E 036 RS Record separator 

031 iF 037 US Unit separator — 

032 20 040 SP Space 

033 21 041 ! Exclamation point @ 

034 22 042 re Quotation marks 

035 23 043 # Number sign 

(Continued) 
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Table C-l. 
ASCII Code 

Decimal (Hexadecimal ) 
036 24 
037 25 
038 26 
039 27 
040 28 
041 29 
042 2A 
043 2B 
044 2C 
045 2D 
046 2E 
047 2F 
048 30 
049 31 
050 32 
051 33 
052 34 
053 35 
054 36 
055 37 
056 38 
057 39 
058 3A 
059 3B 
060 3C 
061 3D 
062 3E 
063 3F 
064 40 
065 4] 
066 42 
067 43 
068 44 
069 45 
070 46 
071 47 
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Octal 


044 
045 
046 
047 


050 
051 
052 
053 


054 
055 
056 
057 


060 
061 
062 
063 


064 
065 
066 
067 


070 
071 
072 
073 


074 
075 
076 
O77 


100 
101 
102 
103 


104 
105 
106 
107 
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Graphic or 
Mnemonic 


ASCII Character Set 


Name or Meaning 


Dollar sign 
Percent sign 
Ampersand 
Apostrophe 


Opening parenthesis 
Closing parenthesis 
Asterisk 

Plus 


Comma 
Hyphen 
Period 
Slant 


Zero 
One 
Two 
Three 


Four 
Five 
Six 
Seven 


Eight 
Nine 
Colon 
Senicolon 


Less than 
Equal to 
Greater than 
Question mark 


Commercial at 
Uppercase A 
Uppercase B 
Uppercase C 


Uppercase 
Uppercase 
Uppercase 
Uppercase 


O = io 


(Continued) 
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ASCII Character Set 


Table C-l. 


Decimal 


072 
073 
074 
075 


076 
077 
078 
079 


080 - 
081 


082 
083 


084 
085 
086 
087 


088 
089 
090 
091 


092 
093 
094 
095 


096 
097 
098 
099 


100 
101 
102 
103 


ASCII Character Set (Continued) 


ASCII Code 


(Hexadecimal ) 


48 
49 


Octal 


110 
111 
112 
113 


114 
115 
116 
117 


120 
121 


122 
123 


124 
125 
126 
127 


130 
131 
132 
133 


134 
135 


136 
137 


140 
141 
142 
143 


144 
145 
146 
147 


Graphic or 
Mnemonic 


m—eN rd bd =s<<davyv mmo; o242Br Ao HM 


> 


GQ FRO 
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Name or Meaning 


Uppercase 
Uppercase 
Uppercase 
Uppercase 


Uppercase 
Uppercase 
Uppercase 
Uppercase 


Uppercase 
Uppercase 


Uppercase 
Uppercase 


Uppercase 
Uppercase 
Uppercase 
Uppercase 


Uppercase 
Uppercase 
Uppercase 


Om = AO Reo 


ARO 'd 


=< CGH 


Z 


Opening bracket 


Reverse slant 
Closing bracket 


Circumflex 
Underline 


Grave accent 


Lowercase 
Lowercase 
Lowercase 


Lowercase 
Lowercase 
Lowercase 
Lowercase 


co rmho A 


(Continued ) 
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ASCII Character Set 


Table C-1. ASCII Character Set (Continued) 


ASCII Code Graphic or 
Decimal (Hexadecimal ) Octal Mnemonic Name or Meaning 
104 68 150 h Lowercase h 
105 69 151 i Lowercase i 
106 6A 152 j Lowercase j 
107 6B 153 k Lowercase k 
108 6C 154 1 Lowercase 1 
109 6D 155 m Lowercase m 
110 6E 156 n Lowercase n 
111 6F 157 re) Lowercase o 
112 70 160 P Lowercase p 
113 71 161 q Lowercase q 
114 72 162 r Lowercase r 
115 73 163 Ss Lowercase s 
116 74 164 t Lowercase t 
117 75 165 u Lowercase u 
118 76 166 V Lowercase v 
119 77 167 Ww Lowercase w 
@ 120 78 170 x Lowercase x 
121 79 171 y Lowercase y 
122 7A 172 Zz Lowercase z 
123 7B 173 { Opening brace 
124 7C 174 | Vertical line 
125 7D 175 } Closing brace 
126 7E 176 ~ Tilde 
127 7/F 177 DEL Delete 
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PPE Catalog Structure D 


Each level in a PPE hierarchy is a structure consisting of a 
hierarchy of subcatalogs and files. PPE creates the subcatalog 
structure within an environment catalog when it creates the 
environment catalog. PPE creates files in the catalog only as they 
are needed. 


The PPE catalog structure is a hierarchy of catalogs with the 
catalog specified on the ENTER PPE command at the top of the 
structure. The default PPE catalog is 

SUSER. PROFESSIONAL ENVIRONMENT. 


Diagrammed, the PPE catalog structure appears as follows: 


Environment Catalog 


rte aise 


SDESCRIPTION 
SOURCE LIBRARY 


LOAD 


$OBJECT_LIBRARY 


BUILD FILES RUN_ FILES 


SOBJECT LIBRARY $LOADMAP 
$INPUT SOURCE MAP $TERMINAL OUTPUT 
SEXPAND ERRORS 
SPROCESSOR INPUT Any imported run 
$PROCESSOR OUTPUT files 
Any imported build files 
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PPE Catalog Structure 


PPE creates entries for two files and two subcatalogs in the PPE 
catalog. The files are: 


SDESCRIPTION 


SOURCE LIBRARY 


File in which PPE maintains the information that 
describes the state of the PPE session when a 
QUIT SAVE command is entered. PPE uses the 
information when it is restarted. 


SCU source library file for this PPE level. 


The subcatalogs in the PPE catalog are: 


»-NODES .LOAD.SOBJECT LIBRARY.BUILD FILES 
«NODES .LOAD.SOBJECT LIBRARY.RUN FILES 


The .NODES.LOAD.SOBJECT LIBRARY.BUILD FILES subcatalog contains any 
imported build files and the following PPE-created files: 


SINPUT SOURCE MAP 


SEXPAND ERRORS 


$PROCESSOR_INPUT 


SPROCESSOR_ OUTPUT 


The deck expansion writes the source map to 
this file; it must be specified as the 

INPUT SOURCE MAP parameter value in the build 
processor parameter list. The source map is 
the information required for the mapping of 
build diagnostics into the deck text where the 
errors were detected and for the full-screen 
debugger to find the source it displays during 
debugging. 


The deck expansion process writes any errors 
found to this file. 


The deck expansion writes the expanded source 
text to this file; it must be specified as the 
INPUT parameter value in the build processor 
parameter list. 


The build processor writes the object modules 
it generates to this file and the object 
library generator uses it as input when 
combining the modules with the object library. 
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PPE Catalog Structure 


The .NODES.LOAD.SOBJECT LIBRARY.RUN FILES subcatalog contains any 
imported run files and the following PPE-created files: 


$LOADMAP Default load map file. If no other file is 
specified by the LOAD MAP program attribute, 
the load map generated by the run (if any) is 
written to this file. (A load map is generated 
only if the appropriate options are specified 
by the LOAD MAP OPTIONS program attribute.) 


STERMINAL OUTPUT File on which output written to SOUTPUT is 
captured. The file can be viewed after the run 
using EDIT RUN FILE. 


To allow another PPE level to link to your PPE catalog, you must 
permit the following file access to the owner of the other level. 


Access File 
Read SDESCRIPTION 
Read, modify, and cycle SOURCE LIBRARY 


(plus APPLICATION _ 
INFORMATION=" 117) 


Read and execute -LOAD.$OBJECT_LIBRARY.BUILD FILES. 
SOBJECT_LIBRARY 


Control permission is required if the user wants PPE to delete low 
cycles of source libraries during transmits. 


Assume that your environment catalog is the default catalog, 
SUSER.PROFESSIONAL ENVIRONMENT, and that the user name to which you 
want to give access is FRED. You can create various file and 
catalog permits that allow FRED to link to your level. Two examples 
follow: 


1. You can give FRED access to your level with the catalog permit: 


create catalog permit, .. 
catalog=Suser.professional environment, group=user, .. 
user=fred, .. a 
access modes=(read, modify, cycle, control, execute), .. 
share_mode=none 


With this permission, FRED can access all files at your level. 
You can restrict access to files at your level by setting more 
restrictive file permits on these files. For example, if you 
want to allow only read access to the file SDESCRIPTION create 
the following file permit: 


create file permit, .. 


file=Suser.professional environment .$description, .. 
group=user, user=fred, access modes=read, share mode=none 
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PPE Catalog Structure 


2 You can give FRED access to individual files at your level with -_ 
the following SCL commands: 


set_working catalog, Suser.professional environment 


create file permit, file=Sdescription, group=user, .. & 
user=fred, access modes=read, share mode=none 


create file permit, file=source library, group=-user, .. 
user=fred, .. 
access modes=(read, modify, cycle, control), .. 
share _mode=none, application_information="I1” 


create file permit, .. 

f=nodes .load.$object_library.build_files.$object_library, ace 
group=user, user=fred, access modes=(read, execute) .. 
share_mode=none 


Note that the last file permit can be made only after a build 
has occurred at your level. Otherwise, only the file permits 


for the files SDESCRIPTION and SOURCE LIBRARY can be created, 
and user name FRED can access only these files when linked to 
your level. 
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PPE Function Key Summary 


Pri 


The following is an alphabetical listing of the function key labels 
and the operation performed by the corresponding function key. 


Function 


Screen on 
Which the 
Label Appears 


PPE Operation 


Assist 


Back 


BacTC 


FSE session requested 
from the Build Errors 


All screens except 
Environment Description 


Screen Stack 


All except Screen Stack 


Deck List 
Modification List 


Build Errors 

Build Files 

Deck List 

Environment Description 
Library Lists 
Modification List 
Parameter List 
Parameter List Library 
Run Files 

Screen Stack 


Displays the online manual 
explanation of an error 
message. 


Returns to the preceding 
screen on the screen stack. 


Pops the screen stack to 
display the PPE screen under 
the cursor. 


Displays the Banner screen. 


Displays the Build Files 
screen. 


Repositions the list so that 
the first object displayed 
becomes the last object 
displayed. 
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(Continued) 
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PPE Function Key Summary 


(Continued) 

Function Screen on 

Key Which the 

Label Label Appears PPE Operation 

Bprocs Build Errors Displays the Build 

Build Files Processors screen. 
Deck List 

Environment Description 

Library Lists 

Modification List 

Run Files 

Tailor Options 

BuiD Deck List Builds each selected deck 
(if the deck is expandable). 

Build Deck List Builds all expandable decks 

FSE session that have changed since the 
last build. 

ChaBP Build Processors Selects the build processor 
used by subsequent builds. 

ChaCM Modification List Selects the modification 
used by subsequent edit 
sessions. 

ChaDC Environment Description Selects the highest PPE 
level whose contents are 
included in displayed lists. 

Create Deck Creation Executes the creation 
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Modification Creation 


Deck List 
Modification List 
Parameter List Library 


request. 


Displays the Deck Creation, 
Modification Creation, or 


Parameter List screen, 
respectively. 


(Continued) 
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PPE Function Key Summary 


(Continued) 

Function Screen on 

Key Which the 

Label Label Appears PPE Operation 


Delete Build Files Deletes the selected objects 
Deck List from the list. 

Library Lists 
Modification List 
Run Files 
Parameter List Library 

DisREC FSE session requested Displays the number of error 
from the Build Errors messages remaining in the 
screen deck being edited. 

Down Build Errors Repositions the list so that 
Build Files the object under the cursor 
Deck List is the last object displayed. 
Environment Description 
Library Lists 
Modification List 
Parameter List 
Parameter List Library 
Run Files 
Screen Stack 

EdiDT Build Processors Starts an FSE session to 

edit the selected deck 
template. 

EdiPL All screens except the Displays the Parameter List 
Banner or Screen Stack screen to edit the selected 
screens parameter list for the 

selected build processor. 

Edit Build Errors Starts an FSE session to edit 
Deck Creation the selected deck. 

Deck List 
Build Files Displays the information in 
Run Files the selected file. 

EndM Build Errors Marks the last object in a 
Deck List range of selected decks. 
Modification List 

Errors Deck List Displays the Build Errors 

screen. 
(Continued) 
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PPE Function Key Summary 


(Continued) 
Function Screen on 
Key Which the 
Label Label Appears PPE Operation 
Export Build Files Copies the file selected from 
Run Files the list to another file 
outside of PPE. 
ExtS Build Errors Copies the selected decks 
Deck List from their nearest residence 
in the higher levels of the 
PPE hierarchy to your PPE 
level and sets an interlock 
on each deck. 
First Build Errors Repositions the list so that 
Build Files the beginning of the list is 
Deck List displayed and the cursor is 
Environment Description on the first object in the 
Library Lists list. 
Modification List 
Parameter List 
Parameter List Library 
Run Files 
Screen Stack 
ForST FSE session Executes the source text 
formatter. 
Fwd Build Errors Repositions the list so that 
Build Files the last object displayed 
Deck List becomes the first object 
Environment Description displayed. 
Library Lists 
Modification List 
Parameter List 
Parameter List Library 
Run Files 
Screen Stack 
Global Parameter List Library Selects the parameter list 
under the cursor as the 
parameter list used by 
subsequent builds. 
Help All screens Displays information about 
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the keyword under the cursor. 


(Continued ) 
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Function 
Key 
Label 


Home 


Import 


Insert 


Last 


LLists 


Locate 


Screen on 
Which the 
Label Appears 


All screens except 
the Banner screen 


Build Files 
Run Files 


Environment Description 


Library Lists 


Build Errors 

Build Files 

Deck List 

Environment Description 
Library Lists 
Modification List 
Parameter List 
Parameter List Library 
Run Files 

Screen Stack 


Build Errors 

Build Files 

Build Processors 

Deck List 

Environment Description 
Modification List 

Run Files 

Tailor Options 


Deck List 
Modification List 


PPE Function Key Summary 


PPE Operation 


Positions the cursor at the 
beginning of the home line. 


Copies a file from outside of 
PPE to a file in the Build 
Files or Run Files 
subcatalog. 


Combines the specified SCU 
source library outside of 
PPE with the PPE source 
library at this level. No 
interlocks are set. 


Inserts a blank list entry 
before the list entry under 
the cursor. 


Repositions the list so that 
the end of the list is 
displayed and the cursor is 
on the last object in the 
list. 


Displays the Library Lists 
screen. 


Searches the list for the 
first name containing the 
string of characters and 
positions the cursor on that 
name. 
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PPE Function Key Summary 


(Continued) 
Function Screen on 
Key Which the 
Label Label Appears PPE Operation 
Lookup FSE session Searches for the word under 
the cursor in the index of 
the online manual for the 
language and, if found, 
displays the associated 
online manual screen. 
Lower Deck List Lowers the display ceiling 
Environment Description one level. 
Modification List 

Mark Build Errors Marks the first object in a 
Deck List range of selected decks. 
Modification List 

NxtErr FSE session Locates the next highlighted 
error message; deletes the 
current highlighted error 
message. 

PLists All screens except Displays the Parameter List 

Banner, Screen Stack, Library screen. 
and Parameter List 
Print Build Files Prints the selected file 
Run Files using the site-provided 
PRINT command; otherwise, 
the standard SCL PRINT FILE 
command is used. 

Quit All screens Ends the PPE session. Your 
next PPE session will begin 
where this one ends. 

Raise Deck List Raises the display ceiling 

Environment Description one level. 
Modification List 

Refrsh All screens Clears and replots the PPE 
screen. 

Reset Parameter List Sets the parameter under the 


cursor to its default value. 


(Continued) 
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PPE Function Key Summary 


(Continued) 

Function Screen on 

Key Which the 

Label Label Appears PPE Operation 

RFiles Deck List Displays the Run Files 
Modification List screen. 

Run Run Files Loads and executes the 

product. 

SCUOb} Deck List Displays the Deck List or 
Environment Description Modification List screen. 
Modification List 

Skip FSE session Locates the next line with 

an error. Deletes all error 
messages associated with the 
same source line as the 
currently highlighted 
message. 

Stack All screens except Displays the Screen Stack 
Banner and Screen Stack screen. 

Tailor Build Errors Displays the Tailor Options 
Build Files screen. 

Build Processors 

Deck List 

Environment Description 

Library Lists 

Modification List 

Run Files 

TraS Deck List Transmits the selected 

decks, copying them to the 
next higher PPE level and 
deleting them from the 
lowest level in which it 
resides. 

UnMark Build Errors Removes all marks from the 


Deck List 
Modification List 


list. 
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PPE Function Key Summary 


(Continued) 

Function Screen on 

Key Which the 

Label Label Appears PPE Operation 

Undo Build Files Removes the effect of the 
Deck List last logical deletion 
Library Lists operation, restoring the 
Modification List logically deleted objects. 


Run Files 
Parameter List Library 


Up Build Errors Repositions the list so that 
Build Files the object under the cursor 
Deck List is the first object 
Environment Description displayed. 


Library Lists 
Modification List 
Parameter List 
Parameter List Library 
Run Files 

Screen Stack 
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Using PPE F 


This chapter describes some procedures that can help you use PPE. 
These procedures include: 


@ Moving existing SCU based software to a PPE hierarchy 
e Using PPE to begin a new project 

e Using NOS/VE from within PPE 

e Direct use of SCU 

e Customizing PPE function key assignments 


This chapter does not describe how to perform the PPE operations. 
See chapter 3, PPE Operations, for descriptions of how to perform 
the primary PPE operations. See chapter 4, PPE Quick Reference, for 
comprehensive descriptions of all PPE screens and commands. See 
appendix E, PPE Function Key Summary, for a description of all 
default function key labels and their use. 


@ Moving Existing SCU Based Software 
to a PPE Hierarchy 


The following steps show how to move existing SCU based software 
into PPE environment catalog hierarchies. 


1. Divide your software into categories. Make sure that each 
category is a managable size. If a category is too large to 
manage, subdivide it until all subdivisions are managable. Once 
you have decided how to categorize the software, clear all deck 
interlocks and combine the source text for each category into an 
SCU library reserved for that category. 


The most common method of division is by product. For example, 


if your site offers an editor, a compiler, and a loader, combine 
the source for each onto separate libraries as illustrated below. 


SOURCE | SOURCE SOURCE 
LIBRARY LIBRARY LIBRARY 


edit file cybil loader 
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Moving Existing SCU Based Software to a PPE Hierarchy 


2. Use PPE to create a unique environment catalog for each product 
category. Each environment catalog is the topmost level of the 
product category environment catalog hierarchy. Import the 
source library for the product category into its environment 
catalog using the IMPORT SOURCE LIBRARY command from the 
Environment Description screen. See Chapter 4, PPE Quick } 
Reference, for information about the Environment Description 
screen. 


3. After importing a source library, specify information 
identifying the level and the owner of its environment catalog 
on the Environment Description and Tailor Options screens. For 
example, specify the following information for each environment 
catalog created: 


e A descriptive name for the level, like MASTER, TOP, or 
INTEGRATION. These names indicate that the catalog is the 
topmost level of its hierarchy. 


@ The build processor. Options are NOS/VE COBOL, CYBIL, 
FORTRAN, and VECTOR FORTRAN. 


e The owner of the level. 


e An interlock value that uniquely identifies the owner. 


e The build defaults. @ 


® The run defaults. 


Since each SCU library imported into an environment catalog from 
existing software belongs at the topmost level of its PPE 
environment catalog hierarchy, the This level is linked to: 

field of the Environment Description screen should be left empty. 


For example, create an environment catalog for the CYBIL 
compiler called CYBIL INTEGRATION. Then import the CYBIL source 
library into CYBIL_ INTEGRATION. The environment catalog 
structure for the CYBIL INTEGRATION environment catalog 
hierarchy appears similar to the following: 


CYBIL 
INTEGRATION 
SOURCE 
LIBRARY 


cybil 
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Moving Existing SCU Based Software to a PPE Hierarchy 


Initially, no other environment catalogs are linked to 
CYBIL INTEGRATION. 


Use the NOS/VE commands CREATE FILE PERMIT and 

CREATE CATALOG PERMIT to create the permits for each environment 
catalog that needs to extract source from the topmost catalog. 
These permits allow the members of the project to link their 
environment catalogs to the topmost catalog, thus forming a PPE 
environment catalog hierarchy. See appendix D, Environment 
Catalog Structure, for more information about environment 
catalog hierarchies. 


For example, if Fred and Martha belong to the CYBIL project, 
create file permissions allowing them to link their environment 
catalogs to the CYBIL INTEGRATION catalog by executing the 
following commands: 


set working catalog Suser.cybil integration 


create file permit file=Sdescription group=user .. 
user=(fred,martha) .. 
access modes=read share_mode=none 


create file permit file=source library group=user .. 
user=(fred,martha) .. 

access modes=(read, modify, cycle, control) .. 

share mode=none application_information="I1~ 


create file permit .. 
file=nodes.load.$object_library.build files.$object library .. 
group=user user=(fred,martha) access modes=(read, execute) .. 
share mode=none 


Each analyst creates an environment catalog for each product 
area maintained. Then each each analyst”s catalog is linked to 
the corresponding project level environment catalog or to the 
highest level of the hierarchy. Catalog and file permits are 
not required for the analyst”s environment catalog since it is 
the lowest level of the environment catalog hierarchy. 


For example, if Martha is responsible for the front end of the 
CYBIL compiler, she would create the environment catalog 

FRONT END. If Fred is responsible for the code generator for 
CYBIL, he would create the environment catalog CODE GENERATOR. 
Using the permissions established above, they would link their 
catalogs to the CYBIL INTEGRATION catalog, creating an 
environment catalog hierarchy. Since Martha and Fred are at the 
bottom of the hierarchy, they do not need to establish permits 
to their environment catalogs. 
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The CYBIL INTEGRATION environment catalog hierarchy appears 


similar to the following: 


CYBIL 
INTEGRATION 
SOURCE 
LIBRARY 


cybil 


FRONT END 


Martha 
SOURCE SOURCE 
LIBRARY LIBRARY 


Fred and Martha can now extract decks from the CYBIL INTEGRATION 
catalog, update the decks in their environment catalogs, and 
transmit the changed source back to the CYBIL INTEGRATION 
catalog. 


CODE GENEATOR 


Fred 


Project leaders desiring control over which modifications to a 
product are transmitted to the highest level can create an 
intermediate environment catalog to which all project members must 
transmit their code. This catalog can be linked to the project 
level catalog or the top most catalog in the hierarchy. Then the 
project leader can select which modifications to send to the highest 
level of the hierarchy. File and catalog permits must be created 
for the intermediate catalog to allow project members to link their 
catalogs to it. 


More than one project level environment catalog can be created. 
When this is done, each level typically represents some logical 

division of the work done on the product. For example, a project 
responsible for a compiler might divide the work into the subareas 

"front end" and "code generator". Thus modifications to these areas 

are controlled separately. 
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Using PPE to Begin a New Project 


There are many ways to begin a new project using PPE. The method 
you use is largely dependent on the number of analysts initially 
involved at the start of the project and how quickly they will need 
to share source and object code. 


On a project starting with one or two analysts, you might elect to 
create an environment catalog for each analyst. These analysts then 
work independently of each other (avoiding duplication of deck 
names, variable names, and so forth) until they need to share 
resources. This approach requires analysts who work well together 
and who do not need to share resources. 


For example, if Fred and Martha are beginning a new project, each 
would create an environment catalog from which to begin the 
project. The catalogs might appear similar to the following: 


Analyst 
Level FREDS MARTHAS 

UNTESTED UNTESTED _ 

CODE CODE — 


@ When the project requires more coordination among analysts, one or 
More project level environment catalogs can be created. Then each 
analyst”s catalog can be linked to a project level catalog, the 
source from which is transmitted to the project level catalog. All 
further work on the project occurs within the project environment 
catalog hierarchy. 


For example, two project level catalogs and an additional member may 
be required to continue Fred and Martha’s project. The environment 
catalog hierarchy that results from linking these environment 
catalogs might appear similar to the following: 


Project 
Level UNIT 


TESTED | 
CODE! 


UNIT 
TESTED _ 
CODE1 


@ Analyst 


Level FREDS 
UNTESTED 
CODE 


MARTHAS _ 
UNTESTED 
CODE 


GEORGES _ 
UNTESTED 
CODE — 
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Development continues at this stage of the project until enough of 
the product is created and tested to bring in system integrators. 
Then create a top most integration level environment catalog and 
link the project level catalogs to it. Transmit the project level 
source to the new top level of the environment catalog hierarchy. 

At this point, the structure of the new project is indistinguishable & 
from that of a project that began using PPE after the maintainence 
phase. Developers can extract, edit, and transmit decks as required 
to finish the project. If more project levels or more analysts are 
required, additional environment catalogs can be created and linked 
to the hierarchy. 


The hierarchy that results from linking the project level catalogs 
to a top level integration catalog is similar to the following: 


Integration 
Level SYSTEM _ 
TESTED 

CODE — 
Project © 
Level UNIT UNIT _ 

TESTED TESTED 
CODE1 | CODE1 ~ 

Analyst 
Level FREDS MARTHAS GEORGES 


UNTESTED UNTESTED _ UNTESTED _ 
CODE CODE CODE 


® F-6 Professional Programming Environment Revision B 


Using PPE to Begin a New Project 


A project starting with many analysts who need to share resources in 
the near future should elect to create environment catalogs from the 
top down as described in the discussion on maintaining existing SCU 
based software. The source libraries in this case would all be 
initially empty. They become filled as source is created and 

@ transmitted up the hierarchy. As analysts join and leave the 
project, new environment catalogs are linked to and separated from 
the environment catalog hierarchy. 


A project starting with a full environment catalog hierarchy might 
start with a hierarchy that appears similar to the following: 


Integration 
Level SYSTEM _ 
TESTED 

CODE | 
Project 
Level UNIT UNIT | 

TESTED TESTED 
r CODE1— | = CODET- 

Analyst 
Level ANALYST1 ANALYST2 ANALYST3 


UNTESTED _ UNTESTED _ UNTESTED _ 
CODE CODE CODE 
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Using NOS/VE From Within PPE 


All NOS/VE commands available prior to starting a PPE session are 

also available during the PPE session. To execute a NOS/VE command 

from within a PPE session, move the cursor to the home line of the 

Screen, type the command, and press the carriage-return key. © 
Command utilities such as CREATE OBJECT LIBRARY can be executed from 
within PPE. While you are using a command utility, it controls the 
terminal; on exit from the utility, PPE regains control of the 

terminal. 


A NOS/VE command executed from the home line performs in the style 
communicated to NOS/VE through the CHANGE INTERACTION STYLE 
command. If you set the interaction style to SCREEN and execute 
EDIF Suser.xyz on the home line, the NOS/VE File Editor comes up in 
full-screen mode. If you execute a command that is not a 
full-screen command and the command causes NOS/VE to write data to 
the terminal, the data is displayed. A prompt then appears 
requesting you to press NEXT. Press the carriage-return key to 
return to PPE. 


Regardless of interaction style, if the status parameter of a NOS/VE 
command executed from the home line is not specified and the command 
terminates abnormally, PPE displays the abnormal status in a window 
after it regains control of the terminal. 


To facilitate the creation and maintenance of files contained in the © 
environment catalog, PPE manipulates the working catalog. The 
working catalog is set to the environment catalog when you view most 
of the screens in the PPE screen hierarchy. The exceptions are the 
Build Files and Build Errors screens, which are set to the 

BUILD FILES subcatalog and the Run Files screen which is set to the 
RUN FILES subcatalog. Therefore, if the environment catalog is 
SUSER. XYZ, the Build Files screen is displayed, and you execute the 
command DISPLAY | OBJECT LIBRARY SOBJECT LIBRARY on the home line of 
the screen, the contents of the object library 
SUSER.XYZ.NODES.LOAD.SOBJECT LIBRARY.BUILD FILES.SOBJECT LIBRARY are 
displayed. See Appendix D, PPE Catalog Structure, for information 
about the PPE catalog seeaetuce, 


Direct Use of SCU 


PPE uses the NOS/VE Source Code Utility to provide many of its 
features. As a result of this usage, an SCU session is active the 
entire time PPE runs. All commands issued by you or PPE interact 
with the SCU source library contained in the environment catalog. 


Although all SCU commands are available to you from the PPE home 
line, the END LIBRARY and USE LIBRARY SCU commands should not be © 
executed because they may interfere with PPE. Direct use of these 
commands can cause a source code library PPE is interacting with to 

differ from that which the SCU session is interacting with. 

Differing source libraries for PPE and SCU can cause errors to occur. 
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Much of the value of PPE lies in its ability to automatically 
interact with the proper source code libraries. Avoid using 
END LIBRARY and USE LIBRARY to guarantee that this value is 
preserved. 


Customizing Function Key Assignments 


PPE uses automatic menu assignment to associate commands with 
particular terminal key sequences. A terminal key sequence is 
called a function key, and the function key labels at the bottom of 
a PPE screen are called the menu items. The collection of menu 
items is called the screen menu. 


For any terminal, the primary goals of the menu assignment are to 
associate as many PPE commands as possible with function keys and to 
keep the function key assignments as consistent as possible from 
screen to screen. Unfortunately, these goals can conflict, 
resulting in one or more commands with function key assignments that 
vary from screen to screen. 


The PPE command to function key assignment variation is controlled 
by customizing the PPE function key assignments. You can assign 
commands to particular function keys and display menu items with 
labels different from those provided by PPE. The information about 
function key assignments is stored in a message module. All message 
modules are stored in the object library $SYSTEM.OSFSCOMMAND LIBRARY 

} and the name of a message module is given by piM$natural_ language, 
where pi represents the product identifier and natural language is 
the name of your natural language. You must supply the product 
identifier and natural language to select a message module. For the 
PPE function key assignment menu, the product identifier is SW and 
the natural language is US ENGLISH. 


To obtain a file containing the English PPE message module, execute 
the following commands: 


create object_library 

add_module n=swmSus english 1=$system.osf$command library 
generate library l=mm_ file f=message module 

edit file mm file 


MM FILE is a file that contains CREATE OBJECT LIBRARY subcommands 
specifying the PPE menu item labels and function key assignments. 
You edit MM FILE to change function key assignments and menu item 
labels. After editing MM FILE, use it to generate an object module 
which you add to the command list. The changed function key 
assignments and menu labels become effective on entry to PPE. 
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For example, to force the EDIT DECK command on the Deck List screen 
to appear on function key Fl with the label Modify, edit MM FILE as 
follows: 


1. Change the following lines in MM FILE from: © 


CREATE APPLICATION MENU NAME=DECK LIST 


CREATE MENU ITEM CLASS=" Actions~ SHORT LABEL=" Edit ” 
LONG LABEL="Edit Deck” 


«.- to the following lines assigning the EDIT DECK command to 
function key Fl and changing the short label to Modify from Edit: 


CREATE APPLICATION MENU NAME=DECK LIST 


CREATE MENU ITEM CLASS="Actions~ SHORT LABEL="Modify~ 
LONG LABEL="Edit Deck” KEY=F1 


2. After modifying the menu item, exit the editor and execute the 
commands: 


include file mm file 

generate library 1=my_ppe menus 

quit 

set_command list a=my_ppe menus @ 


Upon entering PPE, the change you made assigns the EDIT DECK 
function to key Fl with the label Modify on the Deck List screen. 
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Although the function key assignments and menu labels can be 
changed, the order of the menu items must remain unchanged. The 
order of the menu items in the file determines which commands are 
affected by your label and key assignment changes. If you change 
the order of the CREATE MENU ITEM commands, the association of 
commands to function keys is also changed. 


The automatic menu assignment operates on menu items for which no 
key assignment is forced. This means that forcing some but not all 
key assignments might result in undesired variations of function key 
assignments from screen to screen. 
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CLEAR 


4-36 


CLEAR SCREEN 4-36 


CLES 
CREATE 
CREATE 


CREATE | 


CREATE | 
CRED 
CREM 
CREPL 
DELBF 
DELD 
DELETE 
DELETE 
DELETE 


DELETE 
DELETE 


DELETE | 


DELETE _ 
DELETE 
DELIE 
DELLE 
DELM 
DELPL 
DELRF 
DISB 
DISBE 
DISBF 
DISBP 
DISLL 


4-36 
3-7, 10, 12; 4-37, 38 
DECK 3-10, 12; 4-37 
“MODIFICATION 3-7; 4-38 
PARAMETER LIST 4-38 
3-10, 12; 4-37 
3-7; 4-38 
4-38 
4-39 
4-40 
4-39, 40, 42, 43, 44, 45 


_ BUILD FILE 4-39 
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IDENTICAL ERRORS 3-25, 26, 27; 4-41 


LIST ENTRY 4-42 
MODIFICATION 4-43 
PARAMETER LIST 4-44 
RUN FILE 4-45 
3-27; 4-41 
4-42 
4-43 
4-44 
4-45 
4-45 
3-23, 24; 4-46 
4-46 
2-10.33; 3-12; 4-46 
4-46 


DISPLAY BANNER 4-45 

DISPLAY BUILD ERRORS 3-23, 24; 4-46 

DISPLAY BUILD FILES 4-46 
DISPLAY BUILD PROCESSORS 2-10.3; 3-12; 4-46 
DISPLAY LIBRARY LISTS 3-28; 4-46 

DISPLAY PARAMETER LIST LIBRARY 4-47 
DISPLAY REMAINING ERROR COUNT 3-27; 4-47 
DISPLAY RUN FILES 4-48 

DISPLAY SCREEN STACK 3-3; 4-48 

DISPLAY SCU OBJECT LIST 3-6, 9, 13, 18, 21, 24, 32; 4-48 
DISPLAY TAILOR OPTIONS 2-11; 4-49 


DISPLL 
DISREC 
DISRF 
DISSOL 
DISSS 
DISTO 
DOWN 
EDIBF 
EDID 
EDIDT 
EDIPL 
EDIRF 
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EDIT 3-18, 19, 20, 25; 4-49, 50 
EDIT BUILD FILE 4-49 
EDIT DECK 3-18, 19, 25; 4-50 
EDIT DECK TEMPLATE 3-13; 4-50 
EDIT PARAMETER LIST 4-51 
EDIT RUN FILE 3-31; 4-52 
END MARK 3-17; 4-53 
ENDM 3-17; 4-53 
ENDMRK 3-17; 4-53 
ENTER PPE 2-5 
ENTP 2-5 
ERRORS 3-24; 4-46 
EXPBF 4-53 
EXPEM 3-26; 4-53 
EXPLAIN ERROR MESSAGE 3-26; 4-53 
EXPORT 4-53, 54 
EXPORT BUILD FILE 4-53 
EXPORT RUN FILE 4-54 
EXPRF 4-54 
EXTRACT SOURCE 4-54 
EXTS 4-54 
FIRST 3-16; 4-62 
FORMAT SOURCE TEXT 3-20; 4-55 
FORST 3-20; 4-55 
FWD 3-15; 4-63 
GLOBAL 4-36 


HELP 4-67 
HOMC 4-56 
HOME 4-56 


HOME CURSOR 4-56 

IMPBF 4-56 

IMPORT 3-4; 4-56, 57 
IMPORT BUILD FILE 4—56 
IMPORT RUN FILE 4-56 
IMPORT SOURCE LIBRARY 3-4; 4-57 
IMPRF 4-56 

IMPSL 3-4; 4-57 

INSERT 4-57 
INSERT LIST ENTRY 4-57 
INSLE 4-57 

LAST 3-16; 4-62 

LLISTS 4-46 

LOCATE 4-58, 59 

LOCATE DECK 4-58 

LOCATE MODIFICATION 4-59 
LOCATE NEXT ERROR 3-25, 26; 4-60 
LOCD 4-58 

LOCM 4-59 

LOCNE 3-25, 26; 4-60 
LOOK 3-19; 4-60 

LOOKUP 3-19; 4-60 

LOOKUP KEYWORD 3-19; 4-60 
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BEGM 3-16; 4-32 

BFILES 4-46 

BKW 3-15; 4-63 

BPROCS 2-10.3; 3-12 

BUICD 3-23; 4-32 

BULD 3-22; 4-33 

build 1-73; 2-10.33; 3-21, 23; 4-32, 33; A-l 
BUILD 3-23; 4-32 

BUILD CHANGED DECKS 3-23; 4-32 

BUILD DECKS 3-22; 4-33 

build defaults 2-12; A-1l 

Build Errors screen 4-3 

build failure 3-23 

Build Files screen 4-4 

build processor 1-3, 8; 2-10.3, 12; A-1l 
Build Processor field 2-10.3 

Build Processors screen 2-10.4; 4-6 
building changed decks 3-23 

building the product 1-7; 3-21, 23 
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CLEAR 4-36 
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command format 4-30 
Command List Entry 4-16 
commands 
BACK 3-3, 8, 11; 4-31 
BACK TO CONTEXT 4-31 
BACK TO PREVIOUS CONTEXT 3-3, 8, 
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BACTPC 4—31 
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LOWDC 4-61 

LOWER 4-61 

LOWER DISPLAY CEILING 4-61 
MARK 3-16; 4-32 
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PRIRF 3-31; 4-65 
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REQH 4-67 

REQUEST HELP 4-67 

RESET 4-36 

RFILES 4-48 

RUN | 4-68 

SCUOBJ 3-6, 9, 13, 18, 21, 24, 32; 4-48 
SKILE 3-27; 4-70 
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SKIP LINE ERRORS 3-25, 26, 27; 4-70 
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TOP 3-15; 4-62 
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TRAS 3-31; 4-70 

UNDLD 4-72 

UNDO 2-13; 4-39, 40, 42, 43, 44, 45, 72 
UNDO_LAST DELETE 2-13; 4-39, 40, 42, 43, 44, 45, 72 
UNMARK 3-17; 4-66 


compilation errors 1-8; 3-23 


Revision B Professional Programming Environment 


Index 


Index—5 @ 


Index 


compile l-/, 83 3-21, 22 
compiler diagnostics 3-25 
CONTAINS DECK DIRECTIVES 3-11 
*COPY 1-3 

*COPYC 1-3 

correcting errors 3-23, 24; 4-60 
CREATE 3-7, 10, 12; 4-37, 38 
CREATE DECK 3-10, 12; 4-37 
CREATE MODIFICATION 3-7; 4-38 
creating 


decks 3-4, 8, ll, 13; 4-37 
modifications 3-5, 8; 4-9, 37; A-2 
parameter lists 4-20, 38 

software in PPE F=1,, 5 


CRED 3-10, 12; 4-37 

CREM 3-7; 4-38 

CREPL 4-38 

current modification 4-4, 12, 19 
customizing function keys F-9 
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building 1-8, 93 3-21, 233; 4-32, 33 
creating 3-5; 4-37 
deleting 4-40 
editing 3-17 
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importing 3-4 
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Deck Creation screen 3-10; 4-8 
Deck List screen 3-9, 22; 4-10 
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run file 4-45 
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DELETE BUILD FILE 4-39 
DELETE DECK 4-40 
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DELETE LIST ENTRY 4-42 
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editing defaults 2-13; 4-29 
editor prolog 2-13 
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END MARK 3-173; 4-53 
ENDM 3-17; 4-53 
ENDMRK 3-17; 4-53 
ENTER PPE 2-5 
ENTP 2-5 
environment 1-3; A-3 
Environment Description screen 2-8; 4-12 
error level 3-30; 4-69 
error level message 3-30 
errors 
build 3-23; 4-70 
Build Errors screen 3-24 
compilation 3-23 
displaying 3-24; 4-70 
execution 4-68 
fixing 3-25, 26, 27; 4-60 
ERRORS 3-24; 4-46 
execute 3-27; 4-68 
execution 1-8; 3-27; 4-68; A-3 
exiting PPE 2-15; 4-65 
expand decks 1-7; 3-11, 21, 223; A-3 
SEXPAND ERRORS 4-33; D-1, 2 
expandable 3-11; 4-9 
EXPBF 4—53 
EXPEM 3-26 
explain 3-20 
EXPLAIN ERROR MESSAGE 3-26 
export 
build file 4-6, 53 
run file 4-54 
EXPORT 4-53, 54 
EXPORT BUILD FILE 4-53 
EXPORT RUN FILE 4-54 
EXPRF 4-54 
extract 1-4; 3-14, 25; 4-54; A-3 
EXTRACT SOURCE 4-54 
extracting 1-4 
extracting decks 1-4; 3-13, 18; 4-54 
EXTS 4-54 


F 


failed build 3=25 

file cycles 2-153. 3-333. 4-71 
file path A-4 

file permit D-3, 4 

FIRST 3-16; 4-61 

FORMAT SOURCE TEXT 3-20; 4-55 
FORST 3-20; 4-55 

full-screen I-l; 2-1; A-4 
Full-Screen Debug 3-30 
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Full-Screen Editor 3-17, 19; 4-50, 52 
full-screen terminal 2-1, 2 

function key 2-2, 3; A-4 

function key summary  E-1l 

FWD 3-15; 4-63 


G 


GLOBAL 4-36 


H 


HAS MULTIPLE PARTITIONS 3-11 
help 2-7; 4-67 
HELP 4-67 
hierarchy A-4 
catalog 1-3 
level name 4-13 
screen 3-1, 2 
HOMC 4—56 
HOME 4-56 
HOME CURSOR 4-56 


IMPBF 4-56 
IMPORT 3-4; 4-56, 57 
IMPORT BUILD FILE 4-56 
IMPORT _RUN FILE 4-56 
IMPORT SOURCE LIBRARY 3-4; 4-57 
importing = 
decks 4-6, 57 
files 3-11; 4-6, 56 
source libraries 3-4; 4-57 
IMPRF 4-56 
IMPSL 3-4; 4-57 
Initial source 3-11; 4-9 
SINPUT SOURCE MAP 4-22, 33; D-l, 2 
INSERT 4-57 
INSERT LIST ENTRY 4-57 
INSLE 4-57 
INTERACTIVE DEBUG 1-9; 4-25, 28 
interlock 1-4; 2-11; 3-5, 13, 32, 33; 4-40, 54; A-5 


L 


LAST 3-16; 4-61 
leaving PPE 2-15; 4-65 
level 1-3, 4, 5; A=-5 
level name 2-8; 4-13 
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Library Lists screen 4-14 
linking 2-9 

linking to a hierarchy 2-9; 4-13 
list 3-15, 16; 4-61, 62, 63 

list entry 3-15, 16; 4-61, 62, 63 
LLISTS 4-46 

LOAD MAP OPTIONS 3-30 

loader 1-9; 3-30 

loading the product 3-30 
SLOADMAP 3-30; 4-69; D-1, 3 
LOCATE 4-58, 59 

LOCATE DECK 4-58 

locate diagnostic messages 3-26, 27 
LOCATE MODIFICATION 4-59 
LOCATE NEXT ERROR 3-25, 26; 4-60 
LOCD 4-58 

LOCM 4-59 

LOCNE 3-26; 4-60 

logically delete 2-13 

LOOK 3-19; 4-60 

looking up a topic 3-19, 25 
LOOKUP 3-19; 4-60 

LOOKUP KEYWORD 3-19; 4-60 

LOWDC 4-61 

LOWER 4-61 

LOWER DISPLAY CEILING 4-61 


M 


maintaining software F-1] 
MARK 3-16; 4-32 
marking 3-16; 4-32, 53, 66 
marking a range 3-17; 4-32, 53 
modification 1-3; A-5 
creating 3-7; 4-16, 35 
deleting 4-43 
Modification Creation screen 3-7; 4-16 
Modification List screen 3-6; 4-18 
modification name 3-7; 4-35 
MOVE TO BOTTOM 3-16; 4-61 
MOVE TO FIRST 3-16; 4-62 
MOVE TO LAST 3-16; 4-62 
MOVE TO TOP 3-15; 4-62 
moving a list 3-15, 16 
MOVTB 3-16; 4-61 
MOVTF 3-16; 4-62 
MOVTL 3-16; 4-62 
MOVTT 3-15; 4-62 
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NAM/CCP 2-4 

name A-5 

naming your level 2-8 
non-expandable decks 3-22 
NONE 2-13 

NORMAL 1-9; 4-25, 28 
NXTERR 3-26 


O 


object 1-1 
decks 1-3; 4-11, 13, 40, 48, 49 
modifications 1-35; 4-11, 13, 43, 48, 49 
parameter lists 3-26; 4-44, 47 
object library 1-1, 9; 3-30; A-5 
SOBJECT LIBRARY 4-71; D-1l 
object module 3-22, 30; A=-5 
online manuals 3-19, 25, 26; 4-60 
original-interlock 1-5 
out put 3-31; 4-6 
SOUTPUT 3-30 


P 


PAGB 3-15; 4-63 
page 3-15, 16 
PAGE BACKWARD 3-15; 4-63 
PAGE FORWARD 3-15; 4-63 
PAGF 3-15; 4-63 
parameter list A-6 
Parameter List Library screen 4-22 
Parameter List screen 4-20 
path 

catalog 229 

file 3-4 

screen 3-3 
physically delete 2-12 
PLISTS 4-47 
PPE session 2—-5 
PPE usage 3715. Fed 
PRIBF 4-64 
PRINT 3-31; 4-6, 64, 65 
PRINT BUILD FILE 4-64 
PRINT RUN_FILE 3-31; 4-65 
printing 4—6, 64, 65 
PRIRF 3-31; 4-65 
processor 2-10.3 
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$SPROCESSOR_INPUT 4-22, 33; D-l, 2 
SPROCESSOR OUTPUT 4-22, 33; D-1l, 2 
product execution 3-27 

program attributes 3-29 

program library list A-6 

Program Library List entry 4-15 


QUI 4-65 
QUIS 4-65 
QUIT 4-65 


QUIT SAVE 4-65 


RAIDC 3-14; 4-66 

raise 3-14; 4-66 

RAISE 3-14; 4-66 

RAISE DISPLAY CEILING 3-14; 4-66 
raising the display ceiling 3-14; 4-66 
range 3-17 

ranges 3-17 

REFRSH 4—36 

REMM 3-17; 4-66 

REMOVE MARK 3-17; 4-66 

removing marks 3-17 

REQH 4-67 

REQUEST HELP 4-67 

RESET 4-36 

RFILES 4-48 

run 1-8, 9; 3-27; 4-68 

RUN 4-68 

run automatically 3-27 

run defaults 2-12; 4-28, 68 

Run Files screen 3-28; 4-24 

run purpose 2-12; 3-28, 30; 4-25, 28, 68 


screen A-6 

screen hierarchy i ae re” 
screen path {3-3 

Screen Stack screen 3-3; 4-26 
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screens 
Banner 2-6; 4-2 
Build Errors 4-3 
Build Files 4-4 
Build Processors 2-10.4; 4-6 
Deck Creation 3-10; 4-8 
Deck List 3-9, 22; 4-10 
Environment Description 2-8; 4-12 
Library Lists 4-14 
Modification Creation 3-7; 4-16 
Modification List 3-6; 4-18 
Parameter List 4-20 
Parameter List Library 4=—22 
Run Files 3-28; 4-24 
Screen Stack 3-3; 4-26 
Tailor Options 2-11; 4-27 
SCU 1-2, 7; A-6 
SCU objects 
decks 1-3; 4-11, 13, 19, 48, 493; A-6 
modifications 1-3; 4-11, 13, 19, 48, 49; A-6 
SCUOBJ 3-6, 9, 13, 18, 21, 24, 32 
SKILE 3-27; 4-70 
SKIP 3-27; 4-70 
SKIP LINE ERRORS 3-25, 26, 27; 4-70 
source library 1-3, 83 A-7 
SOURCE LIBRARY 1-3 
source lines 1-3; 3-8 
source text 1-3; 3-8; A-7 
source text expansion 3-21 
STACK 3-3 
starting PPE 2-5 
starting procedure 1-9; 2-12; 3-30 
STATUS parameter 4-30 
sub-interlock 1-5 
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TAILOR 2-11 

Tailor Options screen 2-113; 4-27 
tailoring 2d 

terminal 2-1, 2 

terminal definition 2-1, 23; A-/ 
STERMINAL OUTPUT 3-30; 4-69; D-l, 3 
termination error level 3-30 
TOP 3-15; 4-61 

topic lookup 3-19... 25 

transmit 1-5; 3-32; 4-70 
TRANSMIT SOURCE 3-32; 4-70 
transmittal A~-7 

transmitting 1=53 3-32 
transmitting decks 1-53; 3-32 
TRAS 3-32; 4-70 
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UNDLD 4-72 

UNDO 2-13; 4-39, 40, 42, 43, 44, 45, 72 

UNDO LAST DELETE 2-13; 4-39, 40, 42, 43, 44, 45, 72 
UNMARK 3-17; 4-66 

user defined prolog 2-13 

User Prolog 4-30 

using NOS/VE  F-8 

using PPE 3-1; F-1 

Using SLU in PPE F-8 
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warning error level 3-30 
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We would like your comments on this manual. While writing it, we made some assumptions about who 
would use it and how it would be used. Your comments will help us improve this manual. Please 
take a few minutes to reply. 


Who Are You? How Do You Use This Manual? Which Are Helpful to You? 

___ Manager ____ As an Overview ____ Command and Function 

____ Systems Analyst or Programmer ___ To learn the Product /System Summaries 

____ Applications Programmer ____ For Comprehensive Reference ____ Related Manuals 
Operator For Quick Look-up Appendix 

~~ Other ~ Online Quick Reference 

7s ~ Other 


What programming languages do you use? 


Which are helpful to you? Parameter Summary (inside cover) Related Manuals Page 


Character Set Other 


How Do You Like This Manual? Check those that apply. 


re 


es Somewhat No 


Is the manual easy to read (print size, page layout, and so on)? 
Is it easy to understand? 

Is the order of topics logical? 

Are there enough examples? 

Are the examples helpful? (___ Too simple Too complex) 

Is the technical information accurate? 

Can you easily find what you want? 

Do the illustrations help you? 

Does the manual tell you what you need to know about the topic? 


i 


Reonecny 
eee egeae 


Comments? If applicable, note page number and paragraph. 


Check here if you want a reply Continue on other side 
rom: 
ane Company 
Address Date 
Phone No. 


tN ef 


lease send program listing and output if applicable to your comment. 
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